"Jean-Noël Avila via GitGitGadget" <gitgitgadget@xxxxxxxxx> writes: > +[synopsis] > +git diff [<options>] [<commit>] [--] [<path>...] > +git diff [<options>] --cached [--merge-base] [<commit>] [--] [<path>...] > +git diff [<options>] [--merge-base] <commit> [<commit>...] <commit> [--] [<path>...] > +git diff [<options>] <commit>...<commit> [--] [<path>...] > +git diff [<options>] <blob> <blob> > +git diff [<options>] --no-index [--] <path> <path> Again, not having to worry about `mark-up` _<rules>_ in SYNOPSIS section is very nice. You may already have explained the rules elsewhere, but please help me refresh my memory with some explanation. > -'git diff' [<options>] [--] [<path>...]:: > +`git diff [<options>] [--] [<path>...]`:: Here, we just say `everything in literal, including placeholders`, which is very pleasant for us writers. > --1 --base:: > --2 --ours:: > --3 --theirs:: > +`-1` `--base`:: > +`-2` `--ours`:: > +`-3` `--theirs`:: Why aren't these `-1 --base` and instead mark up individual tokens? > -<path>...:: > - The <paths> parameters, when given, are used to limit > +_<path>_...:: This has to do the _italics_ for placeholders, unlike the full command line examples we saw earlier? Where does this difference come from? Thanks.
