git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 00/11] Document missing options

From
Jakub Narebski <jnareb@gmail.com>
Date
Jun 16, 2007, 19:03 UTC
Message-ID
<11820206272990-git-send-email-jnareb@gmail.com>

This series of patches documents [some] options which were missing from the documentation.

Table of contents:
==================
 [PATCH 01/11] Use tabs for indenting definition list for options in git-log.txt
 [PATCH 02/11] Document git log --full-diff
 [PATCH 03/11] Document git log --abbrev-commit, as a kind of pretty option
 [PATCH 04/11] Document that '--message=<msg>' is long version of '-m <msg>'
 [PATCH 05/11] Document that '--no-checkout' is long version of '-n' option of git-clone
 [PATCH 06/11] Document git rev-list --timestamp
 [PATCH 07/11] Document git rev-list --full-history
 [PATCH 08/11] Document git rev-parse --is-inside-git-dir
 [PATCH 09/11] Document git read-tree --trivial
 [PATCH 10/11] Document git reflog --stale-fix
 [PATCH 11/11] Document git commit --untracked-files and --verbose
What is still undocumented are:
 * git clone --no-separate-remote, which is deprecated and perhaps
   should be left undocumented.
 * git commit -o|--only, which is now default when providing files
   to be committed, and -i|--include is not present. Description
   of this option was removed in commit 6c96753d:
     "Documentation/git-commit: rewrite to make it more end-user friendly."
   Should we re-add this description?
 * git commit --reedit-message (--reedit) and --reuse-message
   (--reuse). I'm not sure what are the meaning of those options, and
   how they differ from -c (or -C --edit) and -C. I think, but I'm not
   sure, that --reedit-message is long form of -c, and --reuse-message
   is long form of -C.
 * git reflog --dry-run. The --dry-run option in other command describe
   what would be done. I think that this option does not work for this
   command.

I have checked only ling options in builtins and shell scripts; I have not checked Perl scripts not short options, and I might have missed some options for which the same named option but for different command exists in the documentation.

I might have missed modifying usage strings in command source, and in command documentation.

But I think this series of patches is a good start...
---
 Documentation/git-clone.txt      |    1 +
 Documentation/git-commit.txt     |   12 ++++++++++--
 Documentation/git-log.txt        |    9 ++++++++-
 Documentation/git-read-tree.txt  |    8 +++++++-
 Documentation/git-reflog.txt     |   13 +++++++++++++
 Documentation/git-rev-list.txt   |   13 +++++++++++++
 Documentation/git-rev-parse.txt  |    4 ++++
 Documentation/pretty-options.txt |    9 +++++++++
 builtin-read-tree.c              |    2 +-
 9 files changed, 66 insertions(+), 5 deletions(-)

-- Jakub Narebski Poland

Next: Jakub Narebski
Message 1 of 14 in “Document missing options”
  1. 00/11 Document missing optionsJakub Narebski, Jun 16, 2007
  2. 01/11 Use tabs for indenting definition list for options in git-log.txtJakub Narebski, Jun 16, 2007
  3. 02/11 Document git log --full-diffJakub Narebski, Jun 16, 2007
  4. 03/11 Document git log --abbrev-commit, as a kind of pretty optionJakub Narebski, Jun 16, 2007
  5. 04/11 Document that '--message=<msg>' is long version of '-m <msg>'Jakub Narebski, Jun 16, 2007
  6. 05/11 Document that '--no-checkout' is long version of '-n' option of git-cloneJakub Narebski, Jun 16, 2007
  7. 06/11 Document git rev-list --timestampJakub Narebski, Jun 16, 2007
  8. 07/11 Document git rev-list --full-historyJakub Narebski, Jun 16, 2007
  9. 08/11 Document git rev-parse --is-inside-git-dirJakub Narebski, Jun 16, 2007
  10. 09/11 Document git read-tree --trivialJakub Narebski, Jun 16, 2007
  11. 10/11 Document git reflog --stale-fixJakub Narebski, Jun 16, 2007
  12. 11/11 Document git commit --untracked-files and --verboseJakub Narebski, Jun 16, 2007
  13. Junio C HamanoJun 16, 2007
  14. Jakub NarebskiJun 16, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.