Fossil SCM

Recommending adding -N to "fossil diff" commands when piping thru diffstat in the gitusers.md doc.

wyoung 2020-12-10 20:59 trunk
Commit a4e84fb5974058fb60a6fb32e0cec2067395a50da1671d20700a5c3b681f4c3c
1 file changed +4 -1
+4 -1
--- www/gitusers.md
+++ www/gitusers.md
@@ -695,17 +695,20 @@
695695
fossil diff -i --from 2020-04-01 --numstat
696696
697697
The `--numstat` output is a bit cryptic, so we recommend delegating
698698
this task to [the widely-available `diffstat` tool][dst]:
699699
700
- fossil diff -i --from 2020-04-01 | diffstat
700
+ fossil diff -i -N --from 2020-04-01 | diffstat
701701
702702
We gave the `-i` flag in both cases to force Fossil to use its internal
703703
diff implementation, bypassing [your local `diff-command` setting][dcset].
704704
The `--numstat` option has no effect when you have an external diff
705705
command set, and some diff command alternatives like
706706
[`colordiff`][cdiff] produce output that confuses `diffstat`.
707
+
708
+If you leave off the `-N` flag in the second example, the `diffstat`
709
+output won’t include info about any newly-added files.
707710
708711
[cdiff]: https://www.colordiff.org/
709712
[dcset]: https://fossil-scm.org/home/help?cmd=diff-command
710713
[dst]: https://invisible-island.net/diffstat/diffstat.html
711714
712715
--- www/gitusers.md
+++ www/gitusers.md
@@ -695,17 +695,20 @@
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
--- www/gitusers.md
+++ www/gitusers.md
@@ -695,17 +695,20 @@
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 -N --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 If you leave off the `-N` flag in the second example, the `diffstat`
709 output won’t include info about any newly-added files.
710
711 [cdiff]: https://www.colordiff.org/
712 [dcset]: https://fossil-scm.org/home/help?cmd=diff-command
713 [dst]: https://invisible-island.net/diffstat/diffstat.html
714
715

Keyboard Shortcuts

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