docs(readme): update CLI usage section

- fix(compiling): improve portability of builds
- fix(native_comp): crash on launch when gcc homebrew package was not
  installed

.github/workflows/build.yml

@@ -34,7 +34,7 @@ jobs:
         uses: actions/checkout@v2
         with:
           repository: jimeh/build-emacs-for-macos
-          ref: "0.4.12"
+          ref: "0.4.16"
           path: builder
       - uses: ruby/setup-ruby@v1
         with:
@@ -75,6 +75,8 @@ jobs:
           --work-dir '${{ github.workspace }}'
           --native-full-aot
           ${{ github.event.inputs.extraReleaseArgs }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Publish release
         if: steps.check.outcome == 'failure'
         run: >-

README.md

@@ -73,28 +73,6 @@ any issues.
 [releases]: https://github.com/jimeh/emacs-builds/releases
 [7]: https://github.com/jimeh/emacs-builds/issues/7
 
-## Build Process
-
-Building Emacs is done using the [jimeh/build-emacs-for-macos][] build script,
-executed within a GitHub Actions [workflow][]. This is why macOS 10.15.x or
-later is required, as it's the oldest version of macOS available in GitHub
-Actions.
-
-[workflow]:
-  https://github.com/jimeh/emacs-builds/blob/main/.github/workflows/build.yml
-
-Full history for all builds is available on GitHub Actions [here][actions].
-
-[jimeh/build-emacs-for-macos]: https://github.com/jimeh/build-emacs-for-macos
-[actions]: https://github.com/jimeh/emacs-builds/actions
-
-Nightly builds are scheduled for 0:00 UTC every night, based on the latest
-commit from the `master` branch of the [emacs-mirror/emacs][] repository. This
-means a nightly build will only be produced if there have been new commits since
-the last nightly build.
-
-[emacs-mirror/emacs]: https://github.com/emacs-mirror/emacs
-
 ## Untrusted Application
 
 Currently builds are not signed or notarized, meaning macOS cannot verify
@@ -106,6 +84,55 @@ in Finder and select "Open". You will then be given the same warning as before,
 but with a "Open" button now available to trust and open the app. After that you
 can open the application like normal without any warnings.
 
+Builds will soon be signed and notarized, progress is tracked in [Issue #1][1].
+
+[1]: https://github.com/jimeh/emacs-builds/issues/1
+
+## Use Emacs.app as `emacs` CLI Tool
+
+Builds come with a custom `emacs` shell script launcher for use from the command
+line, located next to `emacsclient` in `Emacs.app/Contents/MacOS/bin`.
+
+The custom `emacs` script makes sure to use the main
+`Emacs.app/Contents/MacOS/Emacs` executable from the correct path, ensuring it
+finds all the relevant dependencies within the Emacs.app bundle, regardless of
+it it's exposed via `PATH` or symlinked to from elsewhere.
+
+To use it, simply add `Emacs.app/Contents/MacOS/bin` to your `PATH`. For
+example, if you place Emacs.app in `/Applications`:
+
+```bash
+if [ -d "/Applications/Emacs.app/Contents/MacOS/bin" ]; then
+  export PATH="/Applications/Emacs.app/Contents/MacOS/bin:$PATH"
+  alias emacs="emacs -nw" # Always launch "emacs" in terminal mode.
+fi
+```
+
+If you want `emacs` in your terminal to launch a GUI instance of Emacs, don't
+use the alias from the above example.
+
+## Build Process
+
+Building Emacs is done using the [jimeh/build-emacs-for-macos][] build script,
+executed within a GitHub Actions [workflow][]. This is why macOS 10.15.x or
+later is required, as it's the oldest version of macOS available in GitHub
+Actions.
+
+[jimeh/build-emacs-for-macos]: https://github.com/jimeh/build-emacs-for-macos
+[workflow]:
+  https://github.com/jimeh/emacs-builds/blob/main/.github/workflows/build.yml
+
+Full history for all builds is available on GitHub Actions [here][actions].
+
+[actions]: https://github.com/jimeh/emacs-builds/actions
+
+Nightly builds are scheduled for 0:00 UTC every night, based on the latest
+commit from the `master` branch of the [emacs-mirror/emacs][] repository. This
+means a nightly build will only be produced if there have been new commits since
+the last nightly build.
+
+[emacs-mirror/emacs]: https://github.com/emacs-mirror/emacs
+
 ## Issues / To-Do
 
 Please see [Issues][] for details of things to come, or to report issues.