From 1464d9bcd8d9d9bafaef20fbf2aa1ffce409e290 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Mon, 12 Oct 2020 21:14:03 -0400 Subject: development/google-go-lang: Fix README. Signed-off-by: B. Watson Signed-off-by: Willy Sudiarto Raharjo --- development/google-go-lang/README | 77 ++++++++++++++++++++------------------- 1 file changed, 40 insertions(+), 37 deletions(-) (limited to 'development/google-go-lang') diff --git a/development/google-go-lang/README b/development/google-go-lang/README index cc9bd19d5b21..066318752278 100644 --- a/development/google-go-lang/README +++ b/development/google-go-lang/README @@ -1,55 +1,58 @@ -The Go programming language is an open source project to make programmers more -productive. Go is expressive, concise, clean, and efficient. Its concurrency -mechanisms make it easy to write programs that get the most out of multicore and -networked machines, while its novel type system enables flexible and modular -program construction. Go compiles quickly to machine code yet has the -convenience of garbage collection and the power of run-time reflection. It's a -fast, statically typed, compiled language that feels like a dynamically typed, -interpreted language. +The Go programming language is an open source project to make +programmers more productive. Go is expressive, concise, clean, +and efficient. Its concurrency mechanisms make it easy to write +programs that get the most out of multicore and networked machines, +while its novel type system enables flexible and modular program +construction. Go compiles quickly to machine code yet has the +convenience of garbage collection and the power of run-time +reflection. It's a fast, statically typed, compiled language that +feels like a dynamically typed, interpreted language. The tools are added to the path by putting go.sh and go.csh files in -/etc/profile.d and letting the system's /etc/profile or /etc/csh.login pick it -up. If you want to add any of Go's environment variables you can add them -there. +/etc/profile.d and letting the system's /etc/profile or /etc/csh.login +pick it up. If you want to add any of Go's environment variables you +can add them there. -Also, to easily setup a user-independent path for Go libraries to be installed -to and used, is the GOPATH environment variable. This variable can be colon -delimited. For example, once installing the built google-go-lang package, then -set in your user's ~/.bashrc something like: +Also, to easily setup a user-independent path for Go libraries to +be installed to and used, is the GOPATH environment variable. This +variable can be colon delimited. For example, once installing the +built google-go-lang package, then set in your user's ~/.bashrc +something like: export GOPATH="$HOME" -Then, you'll be able to use the `go` command to install an additional library -that will not need root permission and will be in the compiler's path. -Like so: +Then, you'll be able to use the `go` command to install an additional +library that will not need root permission and will be in the +compiler's path. Like so: go get golang.org/x/tools/cmd/godoc -Now in ~/src you'll have this source code checked-out, and a binary built at -~/bin/godoc +Now in ~/src you'll have this source code checked-out, and a binary +built at ~/bin/godoc -Since the golang idiom is very `go get'able as a limited user, installed -libraries from slackbuilds.org are located outside of GOROOT (which is only for -golang standard library), in /usr/share/gocode -By not setting a system-wide GOPATH defaulting to this location, then it is up -to the user of whether to include this system path as well, like: +Since the golang idiom is very `go get'able as a limited user, +installed libraries from slackbuilds.org are located outside of GOROOT +(which is only for golang standard library), in /usr/share/gocode By +not setting a system-wide GOPATH defaulting to this location, then +it is up to the user of whether to include this system path as well, +like: export GOPATH="$HOME:/usr/share/gocode" -This system source directory is primarly only for buildtime of slackbuilds. +This system source directory is primarly only for buildtime of +slackbuilds. -This is because `go get' iterates through the paths provided, looking for -matching imports. If a match is not found, then is cloned to the first path -provided. You would not want this to be a system path, as to need root -privilege to clone source. +This is because `go get' iterates through the paths provided, looking +for matching imports. If a match is not found, then is cloned to the +first path provided. You would not want this to be a system path, as +to need root privilege to clone source. -As of go1.2, the 'go doc ...' command has been relocated to the go.tools -library (golang-googlecode-gotools), which provide `godoc`. +As of go1.2, the 'go doc ...' command has been relocated to the +go.tools library (golang-googlecode-gotools), which provide `godoc`. -As of go1.5, shared libraries are now supported. The flags to use linking are -available for `go get`, `go install` and `go build`. +As of go1.5, shared libraries are now supported. The flags to use +linking are available for `go get`, `go install` and `go build`. To learn more see `go help buildmode`. - -To elect to run the buildtime tests of this package, provide the environment -variable RUN_TEST=true at build time. +To elect to run the buildtime tests of this package, provide the +environment variable RUN_TEST=true at build time. -- cgit v1.2.3