Fossil

Check-in [1869b58580]
Login

Check-in [1869b58580]

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Update the help text for "fossil branch new" to make it clear that the preferred idiom for branch creation in Fossil is to use the --branch option on the "fossil commit" command.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 1869b58580bc8ebcb8b2cab0030e2e18f5009500a288a592591733c90ff3e7a4
User & Date: drh 2025-03-30 18:40:06.868
Context
2025-03-30
21:04
Clean up the description of the background color adjustments in the change log. ... (check-in: 1c0f93e13f user: drh tags: trunk)
18:40
Update the help text for "fossil branch new" to make it clear that the preferred idiom for branch creation in Fossil is to use the --branch option on the "fossil commit" command. ... (check-in: 1869b58580 user: drh tags: trunk)
11:18
Replaced the mention of "fossil branch new" in the Quick Start doc with a link to the section of the gitusers doc which explains why this is not the recommended way of working with Fossil. Both options remain documented, but now we bring Git expats to the place where many of their _other_ questions are most likely to be answered. ... (check-in: f04b61f7e1 user: wyoung tags: trunk)
Changes
Unified Diff Ignore Whitespace Patch
Changes to src/branch.c.
655
656
657
658
659
660
661






662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
**        but no GLOB argument.  All other options are supported, with -t being
**        an implied no-op.
**
** > fossil branch new BRANCH-NAME BASIS ?OPTIONS?
**
**        Create a new branch BRANCH-NAME off of check-in BASIS.
**






**        Options:
**          --private             Branch is private (i.e., remains local)
**          --bgcolor COLOR       Use COLOR instead of automatic background
**          --nosign              Do not sign the manifest for the check-in
**                                that creates this branch
**          --nosync              Do not auto-sync prior to creating the branch
**          --date-override DATE  DATE to use instead of 'now'
**          --user-override USER  USER to use instead of the current default
**
**        DATE may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in
**        year-month-day form, it may be truncated, the "T" may be
**        replaced by a space, and it may also name a timezone offset
**        from UTC as "-HH:MM" (westward) or "+HH:MM" (eastward).
**        Either no timezone suffix or "Z" means UTC.
**
** Options:
**    -R|--repository REPO       Run commands on repository REPO
*/
void branch_cmd(void){
  int n;
  const char *zCmd = "list";
  db_find_and_open_repository(0, 0);







>
>
>
>
>
>









<
<
<
<
<
<







655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676






677
678
679
680
681
682
683
**        but no GLOB argument.  All other options are supported, with -t being
**        an implied no-op.
**
** > fossil branch new BRANCH-NAME BASIS ?OPTIONS?
**
**        Create a new branch BRANCH-NAME off of check-in BASIS.
**
**        This command is available for people who want to create a branch
**        in advance.  But  the use of this command is discouraged.  The
**        preferred idiom in Fossil is to create new branches at the point
**        of need, using the "--branch NAME" option to the "fossil commit"
**        command.
**
**        Options:
**          --private             Branch is private (i.e., remains local)
**          --bgcolor COLOR       Use COLOR instead of automatic background
**          --nosign              Do not sign the manifest for the check-in
**                                that creates this branch
**          --nosync              Do not auto-sync prior to creating the branch
**          --date-override DATE  DATE to use instead of 'now'
**          --user-override USER  USER to use instead of the current default
**






** Options:
**    -R|--repository REPO       Run commands on repository REPO
*/
void branch_cmd(void){
  int n;
  const char *zCmd = "list";
  db_find_and_open_repository(0, 0);