The main build script for this project is `script/build.go` which
implements Makefile-like building of the `gh` binary and associated man
pages. Our Makefile defers to the Go script.
However, when setting GOOS, GOARCH, and other environment variables to
modify the target for the resulting binary, these environment variables
would affect the execution of `build.go` as well, which was unintended.
This tweaks our Makefile to reset variables like GOOS and GOARCH when
building the `build.go` script itself, ensuring that the built script
runs on the same platform, and adds the ability to pass environment
variables as arguments to `go run script/build.go`. This allows the
following usage on platforms without `make`:
go run script/build.go GOOS=linux
With this style of invocation, the GOOS setting does not actually affect
`go run` itself; just the `go build` that is executed in a child process.
The AUR is a community-based location for PKGBUILDs, Arch's Install scripts.
There is a unofficial PKGBUILD for building and installing `gh` from the git repo.
https://aur.archlinux.org/packages/github-cli-git
GitHub has some special behavior for the `help wanted` label, but not
the `help-wanted` label, so I've renamed ours.
Bonus: updated links to docs.github.com
Not sure if this is a common error or if this is the best way to describe the fix but thought I would add something to help others.
OS: Debian GNU/Linux 9.13 (stretch)
Error running first command of Debian install : `sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key C99B11DEB97541F0`
Full error message:
```
Executing: /tmp/apt-key-gpghome.Fuep9VI9UN/gpg.1.sh --keyserver hkp://keyserver$
gpg: failed to start the dirmngr '/usr/bin/dirmngr': No such file or directory
gpg: connecting dirmngr at '/tmp/apt-key-gpghome.Fuep9VI9UN/S.dirmngr' failed: $
gpg: keyserver receive failed: No dirmngr
```
Reason: Missing dependency `dirmngr`
solution: install `dirmngr` by running: `sudo apt-get install dirmngr`
- Move all Linux installation docs to the separate page to eliminate repetition
- Indicate that only Ubuntu 20.04 is supported for apt-add-repository method
- Pull openSUSE/SUSE out of the "unofficial" section since it refers to
downloading our official packages
- Point out manual installation methods as well
