Fossil SCM

Added info about --numstat to the "Diff Statistics" section of the gitusers doc.

wyoung 2020-12-10 20:55 trunk
Commit 11e3366c21153b6b685164dba7abbeb03911dd998a8e6d79fe66f82d566a1ccc
1 file changed +12 -7
+12 -7
--- www/gitusers.md
+++ www/gitusers.md
@@ -687,20 +687,25 @@
687687
view][infow], though.
688688
689689
690690
#### <a name="dstat"></a> Diff Statistics
691691
692
-Fossil doesn’t have an internal equivalent to commands like
693
-`git show --stat`, but it’s easily remedied by using
694
-[the widely-available `diffstat` tool][dst]:
692
+Fossil’s closest internal equivalent to commands like
693
+`git show --stat` is:
694
+
695
+ fossil diff -i --from 2020-04-01 --numstat
696
+
697
+The `--numstat` output is a bit cryptic, so we recommend delegating
698
+this task to [the widely-available `diffstat` tool][dst]:
695699
696700
fossil diff -i --from 2020-04-01 | diffstat
697701
698
-We gave the `-i` flag here to force Fossil to use its internal diff
699
-implementation, bypassing [your local `diff-command` setting][dcset].
700
-If you had that set to [`colordiff`][cdiff], for example, its output
701
-would confuse `diffstat`.
702
+We gave the `-i` flag in both cases to force Fossil to use its internal
703
+diff implementation, bypassing [your local `diff-command` setting][dcset].
704
+The `--numstat` option has no effect when you have an external diff
705
+command set, and some diff command alternatives like
706
+[`colordiff`][cdiff] produce output that confuses `diffstat`.
702707
703708
[cdiff]: https://www.colordiff.org/
704709
[dcset]: https://fossil-scm.org/home/help?cmd=diff-command
705710
[dst]: https://invisible-island.net/diffstat/diffstat.html
706711
707712
--- www/gitusers.md
+++ www/gitusers.md
@@ -687,20 +687,25 @@
687 view][infow], though.
688
689
690 #### <a name="dstat"></a> Diff Statistics
691
692 Fossil doesn’t have an internal equivalent to commands like
693 `git show --stat`, but it’s easily remedied by using
694 [the widely-available `diffstat` tool][dst]:
 
 
 
 
695
696 fossil diff -i --from 2020-04-01 | diffstat
697
698 We gave the `-i` flag here to force Fossil to use its internal diff
699 implementation, bypassing [your local `diff-command` setting][dcset].
700 If you had that set to [`colordiff`][cdiff], for example, its output
701 would confuse `diffstat`.
 
702
703 [cdiff]: https://www.colordiff.org/
704 [dcset]: https://fossil-scm.org/home/help?cmd=diff-command
705 [dst]: https://invisible-island.net/diffstat/diffstat.html
706
707
--- www/gitusers.md
+++ www/gitusers.md
@@ -687,20 +687,25 @@
687 view][infow], though.
688
689
690 #### <a name="dstat"></a> Diff Statistics
691
692 Fossil’s closest internal equivalent to commands like
693 `git show --stat` is:
694
695 fossil diff -i --from 2020-04-01 --numstat
696
697 The `--numstat` output is a bit cryptic, so we recommend delegating
698 this task to [the widely-available `diffstat` tool][dst]:
699
700 fossil diff -i --from 2020-04-01 | diffstat
701
702 We gave the `-i` flag in both cases to force Fossil to use its internal
703 diff implementation, bypassing [your local `diff-command` setting][dcset].
704 The `--numstat` option has no effect when you have an external diff
705 command set, and some diff command alternatives like
706 [`colordiff`][cdiff] produce output that confuses `diffstat`.
707
708 [cdiff]: https://www.colordiff.org/
709 [dcset]: https://fossil-scm.org/home/help?cmd=diff-command
710 [dst]: https://invisible-island.net/diffstat/diffstat.html
711
712

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button