docs(readme): update Homebrew Cask section

Allow the default builder_ref to be set in the a single location, the
_prepare shared workflow. Other workflows essentially have a override
option, and no longer need explicit default values set.

.github/workflows/_build.yml

@@ -13,13 +13,17 @@ on:
         type: string
       builder_ref:
         description: "Git ref to checkout of build-emacs-for-macos"
-        required: true
+        required: false
         type: string
       builder_args:
         description: Custom arguments passed to build script
         required: false
         default: ""
         type: string
+      build_variant:
+        description: "Optional build number used as version suffix"
+        required: false
+        type: string
       test_build_name:
         description: "Test build name"
         required: false
@@ -65,6 +69,7 @@ jobs:
       git_ref: ${{ inputs.git_ref }}
       git_sha: ${{ inputs.git_sha }}
       build_args: ${{ inputs.builder_args }}
+      build_variant: ${{ inputs.build_variant }}
       test_build_name: ${{ inputs.test_build_name }}
       test_release_type: ${{ inputs.test_release_type }}
     secrets: inherit
@@ -104,6 +109,7 @@ jobs:
       git_ref: ${{ inputs.git_ref }}
       git_sha: ${{ inputs.git_sha }}
       build_args: ${{ inputs.builder_args }}
+      build_variant: ${{ inputs.build_variant }}
       test_build_name: ${{ inputs.test_build_name }}
       test_release_type: ${{ inputs.test_release_type }}
     secrets: inherit

.github/workflows/_build_emacs.yml

@@ -34,6 +34,10 @@ on:
         description: Custom arguments passed to build script
         type: string
         required: false
+      build_variant:
+        description: "Optional build number used as version suffix"
+        type: string
+        required: false
       test_build_name:
         description: "Test build name"
         type: string
@@ -66,8 +70,8 @@ jobs:
           path: bin
       - name: Ensure emacs-builder is executable
         run: chmod +x bin/emacs-builder
-      - uses: nixbuild/nix-quick-install-action@v29
-      - uses: nix-community/cache-nix-action@v5
+      - uses: nixbuild/nix-quick-install-action@v32
+      - uses: nix-community/cache-nix-action@v6
         with:
           primary-key: nix-${{ runner.arch }}-${{ hashFiles('**/flake.*') }}
       - name: Install dependencies
@@ -77,6 +81,11 @@ jobs:
         if: inputs.test_build_name != ''
         run: >-
           echo "args=--test-build '${{ inputs.test_build_name }}' --test-release-type '${{ inputs.test_release_type }}'" >> "$GITHUB_OUTPUT"
+      - name: Prepare build variant args
+        id: build_variant_args
+        if: inputs.build_variant != ''
+        run: >-
+          echo "args=--build-variant ${{ inputs.build_variant }}" >> "$GITHUB_OUTPUT"
       - name: Set git SHA override
         id: emacs_sha
         if: inputs.git_sha != ''
@@ -87,6 +96,7 @@ jobs:
           nix develop --command
           bin/emacs-builder -l debug plan --output build-plan.yml
           --output-dir '${{ github.workspace }}/builds'
+          ${{ steps.build_variant_args.outputs.args }}
           ${{ steps.test_plan_args.outputs.args }}
           ${{ steps.emacs_sha.outputs.sha }}
           '${{ inputs.git_ref }}'
@@ -122,8 +132,8 @@ jobs:
           repository: jimeh/build-emacs-for-macos
           ref: ${{ inputs.builder_ref }}
           path: builder
-      - uses: nixbuild/nix-quick-install-action@v29
-      - uses: nix-community/cache-nix-action@v5
+      - uses: nixbuild/nix-quick-install-action@v32
+      - uses: nix-community/cache-nix-action@v6
         with:
           primary-key: nix-${{ runner.arch }}-${{ hashFiles('**/flake.*') }}
       - name: Download build-plan artifact

.github/workflows/_prepare.yml

@@ -5,30 +5,41 @@ on:
     inputs:
       builder_ref:
         description: Git ref to checkout of build-emacs-for-macos
-        required: true
+        required: false
         type: string
+        default: ""
     outputs:
+      builder_ref:
+        description: Git ref of build-emacs-for-macos at builder_ref
+        value: ${{ jobs.builder-sha.outputs.ref }}
       builder_sha:
-        description: Git SHA of build-emacs-for-macos at builder_ref
+        description: Git commit SHA of build-emacs-for-macos at builder_ref
         value: ${{ jobs.builder-sha.outputs.sha }}
 
 jobs:
   builder-sha:
     runs-on: "macos-13"
     outputs:
-      sha: ${{ steps.builder_sha.outputs.sha }}
+      ref: ${{ steps.ref.outputs.ref }}
+      sha: ${{ steps.sha.outputs.sha }}
     steps:
+      - name: Default git ref check
+        id: ref
+        run: |
+          DEFAULT_BUILDER_REF="v0.6.60"
+          BUILDER_REF="${{ inputs.builder_ref }}"
+          echo "ref=${BUILDER_REF:-$DEFAULT_BUILDER_REF}" >> "$GITHUB_OUTPUT"
       - name: Checkout build-emacs-for-macos repo
         uses: actions/checkout@v4
         with:
           repository: jimeh/build-emacs-for-macos
-          ref: ${{ inputs.builder_ref }}
+          ref: ${{ steps.ref.outputs.ref }}
       - name: Store builder Git SHA
-        id: builder_sha
+        id: sha
         run: |
           BUILDER_SHA="$(git rev-parse HEAD)"
           echo "$BUILDER_SHA" > build-emacs-for-macos-git-sha.txt
-          echo "sha=$BUILDER_SHA" >> $GITHUB_OUTPUT
+          echo "sha=$BUILDER_SHA" >> "$GITHUB_OUTPUT"
           echo "Builder ref ${{ inputs.builder_ref }} resolved to" \
                "commit SHA: $BUILDER_SHA"
       - name: Upload builder git SHA artifact
@@ -58,7 +69,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           repository: jimeh/build-emacs-for-macos
-          ref: ${{ inputs.builder_ref }}
+          ref: ${{ needs.builder-sha.outputs.ref }}
           fetch-depth: 0
       - name: Setup Go
         if: steps.cache.outputs.cache-hit != 'true'

.github/workflows/_release.yml

@@ -49,11 +49,11 @@ jobs:
           name: ${{ inputs.dmg_artifact }}
           path: builds
       - name: Publish disk images to a GitHub Release
-        if: steps.dmg.outputs.result != 'fail'
+        if: steps.dmg.outcome != 'failure'
         run: >-
           bin/emacs-builder -l debug release --plan build-plan.yml publish
           $(find builds -name '*.dmg' -or -name '*.sha256')
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - run: echo 'No DMG artifact available, was there a new commit to build?'
-        if: steps.dmg.outputs.result == 'fail'
+        if: steps.dmg.outcome == 'failure'

.github/workflows/build.yml

@@ -11,9 +11,9 @@ on:
         description: Override Emacs git commit SHA to build
         required: false
       builder_ref:
-        description: "Git ref to checkout of build-emacs-for-macos"
-        required: true
-        default: "v0.6.53"
+        description: "Override git ref to checkout of build-emacs-for-macos"
+        required: false
+        default: ""
       builder_args:
         description: Custom arguments passed to build script
         required: false
@@ -26,6 +26,10 @@ on:
         description: "prerelease or draft"
         required: false
         default: ""
+      build_variant:
+        description: "Optional build number used as version suffix"
+        required: false
+        type: string
       x86_64:
         description: "Build x86_64 version of Emacs"
         required: false
@@ -46,6 +50,7 @@ jobs:
       git_sha: ${{ inputs.git_sha }}
       builder_ref: ${{ inputs.builder_ref }}
       builder_args: ${{ inputs.builder_args }}
+      build_variant: ${{ inputs.build_variant }}
       test_build_name: ${{ inputs.test_build_name }}
       test_release_type: ${{ inputs.test_release_type }}
       x86_64: ${{ inputs.x86_64 }}

.github/workflows/nightly-master.yml

@@ -8,20 +8,6 @@ on:
       git_sha:
         description: Override Emacs git commit SHA to build
         required: false
-      builder_ref:
-        description: "Git ref to checkout of build-emacs-for-macos"
-        required: true
-        default: "v0.6.53"
-      x86_64:
-        description: "Build x86_64 version of Emacs"
-        required: false
-        default: true
-        type: boolean
-      arm64:
-        description: "Build arm64 version of Emacs"
-        required: false
-        default: true
-        type: boolean
 
 jobs:
   build:
@@ -30,7 +16,4 @@ jobs:
     with:
       git_ref: "master"
       git_sha: ${{ inputs.git_sha }}
-      builder_ref: ${{ inputs.builder_ref }}
-      x86_64: ${{ inputs.x86_64 }}
-      arm64: ${{ inputs.arm64 }}
     secrets: inherit

README.md

@@ -82,37 +82,32 @@ for at least a day or two without any obvious issues.
 
 ### Homebrew Cask
 
-1. Install the
-   [`jimeh/emacs-builds`](https://github.com/jimeh/homebrew-emacs-builds)
-   Homebrew tap:
-   ```
-   brew tap jimeh/emacs-builds
-   ```
-2. Install one of the available casks:
-   - `emacs-app` — Latest stable release of Emacs.
-     ```
-     brew install --cask emacs-app
-     ```
-   - `emacs-app-pretest` — Latest pretest build of Emacs.
-     ```
-     brew install --cask emacs-app-pretest
-     ```
-   - `emacs-app-nightly` — Build of Emacs from the `master` branch, updated
-     every night.
-     ```
-     brew install --cask emacs-app-nightly
-     ```
-   - `emacs-app-monthly` — Build of Emacs from the `master` branch, updated on
-     the 1st of each month. These includes native Apple Silicon support.
-     ```
-     brew install --cask emacs-app-monthly
-     ```
-   - `emacs-app-good` for the latest known good nightly build listed on [#7][7]:
-     ```
-     brew install --cask emacs-app-good
-     ```
+The [`jimeh/emacs-builds`](https://github.com/jimeh/homebrew-emacs-builds)
+Homebrew Tap provides the following casks:
 
-[7]: https://github.com/jimeh/emacs-builds/issues/7
+- `jimeh/emacs-builds/emacs-app` — Latest stable release of Emacs.
+  ```bash
+  brew install --cask jimeh/emacs-builds/emacs-app
+  ```
+- `jimeh/emacs-builds/emacs-app-pretest` — Latest pretest build of Emacs.
+  ```bash
+  brew install --cask jimeh/emacs-builds/emacs-app-pretest
+  ```
+- `jimeh/emacs-builds/emacs-app-nightly` — Build of Emacs from the `master`
+  branch, updated every night.
+  ```bash
+  brew install --cask jimeh/emacs-builds/emacs-app-nightly
+  ```
+- `jimeh/emacs-builds/emacs-app-monthly` — Build of Emacs from the `master`
+  branch, updated on the 1st of each month.
+  ```bash
+  brew install --cask jimeh/emacs-builds/emacs-app-monthly
+  ```
+- `jimeh/emacs-builds/emacs-app-good` for the latest known good nightly build
+  listed on [#7][7]:
+  ```bash
+  brew install --cask jimeh/emacs-builds/emacs-app-good
+  ```
 
 ## Apple Silicon
 
@@ -192,8 +187,6 @@ All builds also come with a SHA256 checksum file, which itself can be double
 checked against the SHA256 checksum log output from the packaging step of the
 GitHub Actions workflow run which produced the 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.