Croway commented on code in PR #29428:
URL: https://github.com/apache/camel/pull/29428#discussion_r4511584170


##########
docs/user-manual/modules/ROOT/pages/camel-jbang-launcher-install.adoc:
##########
@@ -127,6 +127,53 @@ one (for example after a `--version LTS` install that 
resolved to 4.22.2), `came
 with a "pinned to version LTS" message. Re-run the installer with `--version 
LTS` (or `--version 4.22`)
 to update instead.
 
+== Nightly development builds
+
+Apache publishes a nightly build of the Camel CLI to the Apache snapshot 
repository, for main and for the
+maintenance branches. It lets you try the latest development code, or a fix 
before its patch release, without
+building Camel yourself.
+
+IMPORTANT: A nightly build is a development build for testing, not an Apache 
release. Do not use it in production.
+
+[source,bash]
+----
+camel self-update --version SNAPSHOT          # the newest nightly build of 
main
+camel self-update --version 4.22.3-SNAPSHOT   # the newest nightly build of a 
maintenance branch

Review Comment:
   **1. A maintenance-branch nightly pin cannot be followed by the next `camel 
self-update`.**
   
   `X.Y.Z-SNAPSHOT` for a maintenance branch installs a launcher built from 
that branch, which does not have this PR. On `camel-4.22.x`, 
`SelfUpdateCommand` refuses any pin, and `camel-4.18.x` has no `self-update` at 
all. So "a later `camel self-update` installs the newest nightly build ... of 
that version" (line 152) only holds for main.
   
   Reproduced against repository.apache.org with this PR's `install.sh`, in an 
empty `HOME`. `camel self-update --version 4.22.3-SNAPSHOT` delegates to the 
same script, then writes the same pin.
   
   ```
   $ sh install.sh --version 4.22.3-SNAPSHOT
   Installed Camel CLI 4.22.3-20261107.143456-15 (a nightly build of 
4.22.3-SNAPSHOT) to .../versions/4.22.3-20261107.143456-15
   $ cat ~/.local/share/camel-cli/pinned-version
   4.22.3-SNAPSHOT
   $ camel version
   Camel CLI version: 4.22.3-SNAPSHOT
   $ camel self-update                       # same with --version SNAPSHOT and 
--version LTS
   ERROR: this install is pinned to version 4.22.3-SNAPSHOT - remove 
.../camel-cli/pinned-version to resume tracking new releases
   ```
   
   The only ways out are deleting the pin file or re-running the installer. 
Re-running `install.sh --version 4.22.3-SNAPSHOT` does work, since the script 
comes from the website. Suggestion: say here, and in the `self-update` footer, 
that a maintenance-branch nightly is updated by re-running the installer. 
Another option is for `self-update --version X.Y.Z-SNAPSHOT` to refuse anything 
other than main's snapshot version and point to the installer.
   
   _Claude Code on behalf of @Croway_



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to