Document --stdin (and other options in setup_revisions)

[Denton-L]

Currently, Git accepts --stdin for the log family of commands. Well really, anything that calls setup_revisions from revisions.c and passes in its argv will implicitly have the --stdin option.

We should explicitly document this (and other) options.

[johnlinp]

What are the "other options"? Can you please elaborate?

[dscho]

What are the "other options"?

I think those are all of the options that are parsed in revision.c, in particular in handle_revision_opt().

The idea being that an interested contributor who wants to pick this up would analyze carefully which options are still undocumented (and where).

[johnlinp]

I found that the file rev-list-options.txt contains the options that are parsed in revision.c, including --stdin. Currently it only appears in git-log.txt and git-rev-list.txt.

Is it a good idea to also put it into the git commands that support those options? Like git-revert.txt, git-show.txt, etc?

[Denton-L]

I don't know the other builtin commands well enough to be able to tell if there would be any negative implications resulting in this change but if you're interested, I think it would be good to submit the patch and see what the mailing list thinks.