From 57bbf87d4e8b285064531a0141f198d461017af9 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Sat, 8 Mar 2025 09:39:55 -1000
Subject: [PATCH] ;tools: ghnightlynotes-push: updates description of "nightly"
 prerelease

---
 Justfile              |   8 ++-
 doc/ghnightlynotes.md | 115 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 121 insertions(+), 2 deletions(-)
 create mode 100644 doc/ghnightlynotes.md

diff --git a/Justfile b/Justfile
index 8a16b6465..9b495cc25 100644
--- a/Justfile
+++ b/Justfile
@@ -1519,9 +1519,13 @@ _on-master-branch:
     # echo "Paste into release created by tags push"
     # echo "Or if that failed, create it manually: https://github.com/simonmichael/hledger/releases/new"
 
-# Generate github release notes and (create/)update the draft release on github with the latest text. Run on release branch.
+# Generate github release notes and push them to the github release named by .version. Run on release branch. Note, might also create or publish the release.
 @ghrelnotes-push:
-    just ghrelnotes | gh release edit -F- `cat .version`
+    just ghrelnotes | gh release edit `cat .version` -F-
+
+# Push the prerelease notes to the github nightly prerelease.
+@ghnightlynotes-push:
+    gh release edit nightly -F doc/ghnightlynotes.md
 
 # Get the id of the latest run of the named workflow.
 @ghrun-id WORKFLOW:
diff --git a/doc/ghnightlynotes.md b/doc/ghnightlynotes.md
new file mode 100644
index 000000000..3a0fcb920
--- /dev/null
+++ b/doc/ghnightlynotes.md
@@ -0,0 +1,115 @@
+Here you can find "nightly" binaries, if any, more recent than the current hledger release.
+By using these and providing feedback, eg in the [#hledger chat](https://hledger.org/support.html), you help us make the next release better.
+To see what's new, click the commits link above.
+
+<details>
+<summary>
+
+## Install
+
+</summary>
+
+<xdetails>
+<summary>
+
+### All platforms
+
+</summary>
+
+If you have [eget](https://github.com/zyedidia/eget), that's a convenient way to download the right binaries for your machine:
+```
+eget simonmichael/hledger --all --tag nightly
+```
+
+Otherwise:
+
+</xdetails>
+<xdetails>
+<summary>
+
+### GNU/Linux, 64-bit Intel
+
+</summary>
+
+At the command line:
+
+```
+cd /usr/local/bin
+curl -fLOC- https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-linux-x64.tar.gz
+tar xzf hledger-linux-x64.tar.gz
+cd
+hledger --version; hledger-ui --version; hledger-web --version    # should show a recent .99 version
+```
+
+</xdetails>
+<xdetails>
+<summary>
+
+### Mac, 64-bit ARM or Intel
+
+</summary>
+
+In a terminal window (don't use your web browser to download, it won't authorise the binaries):
+<!--
+(Hopefully these commands are all installed by default; 
+if not, install [XCode Command Line Tools](https://mac.install.guide/commandlinetools/) 
+and/or [Homebrew](https://brew.sh), and let me know.)
+-->
+
+For ARM macs:
+  ```
+  cd /usr/local/bin
+  curl -fLOC- https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-mac-arm64.tar.gz
+  tar xzf hledger-mac-arm64.tar.gz
+  cd
+  hledger --version; hledger-ui --version; hledger-web --version    # should show a recent .99 version
+  ```
+
+For Intel macs:
+  ```
+  cd /usr/local/bin
+  curl -fLOC- https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-mac-x64.tar.gz
+  tar xzf hledger-mac-x64.tar.gz
+  cd
+  hledger --version; hledger-ui --version; hledger-web --version    # should show a recent .99 version
+  ```
+
+</xdetails>
+<xdetails>
+<summary>
+
+### Windows, 64-bit ARM or Intel
+
+</summary>
+
+In a powershell window (press `WINDOWS-R`, `powershell`, `ENTER`):
+
+1. Make a place to keep installed binaries. You only need to do this once, not for every release:
+    ```
+    mkdir -force $HOME\bin >$null
+    $ENV:PATH += ";"+$HOME+"\bin"
+    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)
+    ```
+
+2. Download and install the release binaries:
+    ```
+    cd $HOME\bin
+    curl https://github.com/simonmichael/hledger/releases/download/refs/tags/1.42.99/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
+    Expand-Archive hledger-windows-x64.zip -DestinationPath . -Force
+    cd $HOME
+    hledger --version; hledger-ui --version; hledger-web --version    # should show refs/tags/1.42.99; if not, check why: where.exe hledger
+    ```
+
+3. Ensure a default journal file exists, and without a problematic encoding. 
+This will allow you to start hledger-web by double-clicking on its icon if you wish.
+    ```
+    out-file -append -encoding ascii $HOME/.hledger.journal
+    ```
+    (I'm not sure why "ascii" is needed here - hledger likes utf8 and understands utf8 BOM headers,
+    but the state of [our unicode support on Windows](https://github.com/simonmichael/hledger/issues?q=is%3Aissue+label%3A%22platform%3A+windows%22+label%3Ai18n)
+    is really unknown, your feedback is welcome.)
+
+</xdetails>
+<xdetails>
+
+</details>