Re: [PATCH v2] doc: Add missing "-n" (dry-run) option to reflog man page

"Robert P. J. Day" <rpjday@crashcourse.ca> writes:

Ah, then at least you are being (locally) consistent. Sorry for a remembo.

As to (global) consistency, in the oldest time we tried to list every options (but only in the fully spelled form, IIRC) in the synopsis section, but later with the proliferation of options, it became more common to use the generic "git subcmd <options>..." form in synopsis and leave not just the description but also the enumeration of the options to the description part of the docs, so we ended up with a mixture in the documentation set. Aiming for global consistency is a very good thing, and we need to decide what model to adhere to and stick to it to the end. If you want to carry the torch and declare that we would list every option and every short-hand (but not "--v", "--ve", "--ver", ..."--verbose" for obvious reasons), I personally am fine with that.