Skip to content

Document --stdin (and other options in setup_revisions) #243

Open

Description

@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.

Activity

  1. johnlinp commented on Jun 24, 2019

    @johnlinp

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

  2. dscho commented on Jun 24, 2019

    @dscho
    Member

    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).

  3. johnlinp commented on Aug 2, 2019

    @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?

  4. Denton-L commented on Aug 23, 2019

    @Denton-L
    MemberAuthor

    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.

  5. added a commit that references this issue on Jul 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions