Fossil SCM
Reworked the "Log" section of the gitusers.md doc from forum feedback, for clarity, and to add more info on command abbreviation.
Commit
3c489671570ba33daed53ae4028c0e8c3a04bdc63d17d4bf180195756b2f2b65
Parent
2b274922996c76c…
1 file changed
+16
-8
+16
-8
| --- www/gitusers.md | ||
| +++ www/gitusers.md | ||
| @@ -602,29 +602,37 @@ | ||
| 602 | 602 | |
| 603 | 603 | fossil pull |
| 604 | 604 | fossil up -n |
| 605 | 605 | fossil diff --from tip |
| 606 | 606 | |
| 607 | -Instead of the “dry run” form of [the “`update` command][up], you can | |
| 607 | +To invert the direction of the `diff`, say instead: | |
| 608 | + | |
| 609 | + fossil diff --from current --to tip | |
| 610 | + | |
| 611 | +Rather than use the “dry run” form of [the `update` command][up], you can | |
| 608 | 612 | say: |
| 609 | 613 | |
| 610 | 614 | fossil timeline after current |
| 611 | 615 | |
| 612 | 616 | …or if you want to restrict the output to the current branch: |
| 613 | 617 | |
| 614 | 618 | fossil timeline descendants current |
| 615 | 619 | |
| 616 | 620 | Note the use of [human-readable symbolic version names][scin] rather than |
| 617 | -cryptic notations. (But if you like brief commands, you can abbreviate | |
| 618 | -the last one as `fossil tim desc curr`.) You might need to add `-n 0` to | |
| 619 | -these commands to bypass the default limit on `timeline` output, 20 | |
| 621 | +cryptic notations. | |
| 622 | + | |
| 623 | +If you prefer brief commands, Fossil lets you abbreviate the last one as | |
| 624 | +far as “`fossil tim d c`”, beyond which the `timeline` command becomes | |
| 625 | +ambiguous with `ticket`. Some of the core Fossil developers set | |
| 626 | +“`alias f=fossil`” in their command shell or symlink the `fossil` | |
| 627 | +executable to `f` so that the command becomes rather obscure: | |
| 628 | +“`f tim d c`”. | |
| 629 | + | |
| 630 | +You might need to add `-n 0` to | |
| 631 | +these `fossil timeline` commands to bypass the default output limit, 20 | |
| 620 | 632 | entries. |
| 621 | 633 | |
| 622 | -To invert the direction of the `diff` command above, say instead: | |
| 623 | - | |
| 624 | - fossil diff --from current --to tip | |
| 625 | - | |
| 626 | 634 | [up]: /help?cmd=update |
| 627 | 635 | |
| 628 | 636 | |
| 629 | 637 | <a id="btnames"></a> |
| 630 | 638 | ## Branch And Tag Names |
| 631 | 639 |
| --- www/gitusers.md | |
| +++ www/gitusers.md | |
| @@ -602,29 +602,37 @@ | |
| 602 | |
| 603 | fossil pull |
| 604 | fossil up -n |
| 605 | fossil diff --from tip |
| 606 | |
| 607 | Instead of the “dry run” form of [the “`update` command][up], you can |
| 608 | say: |
| 609 | |
| 610 | fossil timeline after current |
| 611 | |
| 612 | …or if you want to restrict the output to the current branch: |
| 613 | |
| 614 | fossil timeline descendants current |
| 615 | |
| 616 | Note the use of [human-readable symbolic version names][scin] rather than |
| 617 | cryptic notations. (But if you like brief commands, you can abbreviate |
| 618 | the last one as `fossil tim desc curr`.) You might need to add `-n 0` to |
| 619 | these commands to bypass the default limit on `timeline` output, 20 |
| 620 | entries. |
| 621 | |
| 622 | To invert the direction of the `diff` command above, say instead: |
| 623 | |
| 624 | fossil diff --from current --to tip |
| 625 | |
| 626 | [up]: /help?cmd=update |
| 627 | |
| 628 | |
| 629 | <a id="btnames"></a> |
| 630 | ## Branch And Tag Names |
| 631 |
| --- www/gitusers.md | |
| +++ www/gitusers.md | |
| @@ -602,29 +602,37 @@ | |
| 602 | |
| 603 | fossil pull |
| 604 | fossil up -n |
| 605 | fossil diff --from tip |
| 606 | |
| 607 | To invert the direction of the `diff`, say instead: |
| 608 | |
| 609 | fossil diff --from current --to tip |
| 610 | |
| 611 | Rather than use the “dry run” form of [the `update` command][up], you can |
| 612 | say: |
| 613 | |
| 614 | fossil timeline after current |
| 615 | |
| 616 | …or if you want to restrict the output to the current branch: |
| 617 | |
| 618 | fossil timeline descendants current |
| 619 | |
| 620 | Note the use of [human-readable symbolic version names][scin] rather than |
| 621 | cryptic notations. |
| 622 | |
| 623 | If you prefer brief commands, Fossil lets you abbreviate the last one as |
| 624 | far as “`fossil tim d c`”, beyond which the `timeline` command becomes |
| 625 | ambiguous with `ticket`. Some of the core Fossil developers set |
| 626 | “`alias f=fossil`” in their command shell or symlink the `fossil` |
| 627 | executable to `f` so that the command becomes rather obscure: |
| 628 | “`f tim d c`”. |
| 629 | |
| 630 | You might need to add `-n 0` to |
| 631 | these `fossil timeline` commands to bypass the default output limit, 20 |
| 632 | entries. |
| 633 | |
| 634 | [up]: /help?cmd=update |
| 635 | |
| 636 | |
| 637 | <a id="btnames"></a> |
| 638 | ## Branch And Tag Names |
| 639 |