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

[RFC/PATCH 0/3] Documentation: Improve revision documentation

From
Michael J Gruber <git@drmicha.warpmail.net>
Date
Jul 5, 2010, 16:11 UTC
Message-ID
<cover.1278346173.git.git@drmicha.warpmail.net>

This mini-series sets up a new gitrevisions(7) man page so that people looking for revision syntax don't need to try to find it in git-rev-parse(1) which is cluttered with a lot of unrelated stuff (it's plumbing after all).

If that concepts is OK, I actually suggest changing the actual content a bit. Also, I found a copule of typos around the areas which I touched but saved this for an extension of this series.

Michael J Gruber (3):
  Documentation: split off rev doc into include file
  Documentation: gitrevisions
  Documentation: link to gitrevisions rather than git-rev-parse
 Documentation/Makefile                 |    2 +-
 Documentation/git-cat-file.txt         |    2 +-
 Documentation/git-check-ref-format.txt |    2 +-
 Documentation/git-cherry-pick.txt      |    4 +-
 Documentation/git-diff.txt             |    4 +-
 Documentation/git-fast-import.txt      |    2 +-
 Documentation/git-format-patch.txt     |    2 +-
 Documentation/git-log.txt              |    3 +-
 Documentation/git-push.txt             |    2 +-
 Documentation/git-reflog.txt           |    2 +-
 Documentation/git-rev-parse.txt        |  200 +-------------------------------
 Documentation/git-revert.txt           |    2 +-
 Documentation/git-show-branch.txt      |    2 +-
 Documentation/git-show.txt             |    2 +-
 Documentation/git.txt                  |    2 +-
 Documentation/gitcore-tutorial.txt     |    2 +-
 Documentation/gitk.txt                 |    2 +-
 Documentation/gitrevisions.txt         |   35 ++++++
 Documentation/revisions.txt            |  199 +++++++++++++++++++++++++++++++
 Documentation/user-manual.txt          |    8 +-
 20 files changed, 257 insertions(+), 222 deletions(-)
 create mode 100644 Documentation/gitrevisions.txt
 create mode 100644 Documentation/revisions.txt
Next: Michael J Gruber
Message 1 of 8 in “Documentation: Improve revision documentation”
  1. 0/3 Documentation: Improve revision documentationMichael J Gruber, Jul 5, 2010
  2. 1/3 Documentation: split off rev doc into include fileMichael J Gruber, Jul 5, 2010
  3. 2/3 Documentation: gitrevisionsMichael J Gruber, Jul 5, 2010
  4. Stephen BoydJul 14, 2010
  5. Michael J GruberJul 14, 2010
  6. Stephen BoydJul 14, 2010
  7. 3/3 Documentation: link to gitrevisions rather than git-rev-parseMichael J Gruber, Jul 5, 2010
  8. Ævar Arnfjörð BjarmasonJul 5, 2010

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.