Skip to content

Documentation: Improve revision documentation

Michael J Gruber git 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest3 patches 4 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/3Documentation: split off rev doc into include fileDocumentation/git-rev-parse.txt Documentation/revisions.txt+200 -1990 replies
2/3Documentation: gitrevisionsDocumentation/Makefile Documentation/gitrevisions.txt+36 -13 replies
3/3Documentation: link to gitrevisions rather than git-rev-parseDocumentation/git-cat-file.txt Documentation/git-check-ref-format.txt Documentation/git-cherry-pick.txt +13 more+21 -220 replies

Reviews trailers per patch

None of the 3 patches has a Reviewed-by or Acked-by of their own; the series has one for all of them.

PatchÆvar Arnfjörð Bjarmason
SeriesA-b
1/3
2/3
3/3

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

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

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