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

[PATCH v2 0/7] documentation cleanups for <rev>^{<type>}

From
RHRichard Hansen <rhansen@bbn.com>
Date
Sep 2, 2013, 05:34 UTC
Message-ID
<1378100066-31889-1-git-send-email-rhansen@bbn.com>

The documentation for the <rev>^{<type>} syntax (e.g., v1.8.4^{tree}) needed some fixing, and the fixes motivated some other documentation cleanups.

Changes since v1 (2013-06-18, see
<http://thread.gmane.org/gmane.comp.version-control.git/228325>):
  * standardize on 'treeish' (don't use 'tree-ish')
  * standardize on 'committish' (don't use 'commit-ish')
  * don't base the definition of 'committish' on the broken definition
    of 'ref'
  * fix the definition of 'treeish' so that it is not based on the
    broken definition of 'ref'
  * fix the definiton of 'ref'
Richard Hansen (7):
  glossary: mention 'treeish' as an alternative to 'tree-ish'
  glossary: define committish (a.k.a. commit-ish)
  use 'treeish' instead of 'tree-ish'
  use 'committish' instead of 'commit-ish'
  glossary: more precise definition of treeish (a.k.a. tree-ish)
  revisions.txt: fix and clarify <rev>^{<type>}
  glossary: fix and clarify the definition of 'ref'
 Documentation/RelNotes/1.6.0.5.txt       |  2 +-
 Documentation/RelNotes/1.6.2.4.txt       |  2 +-
 Documentation/RelNotes/1.8.1.2.txt       |  2 +-
 Documentation/RelNotes/1.8.2.txt         |  2 +-
 Documentation/diff-format.txt            | 10 +++----
 Documentation/diff-generate-patch.txt    |  2 +-
 Documentation/git-archive.txt            |  4 +--
 Documentation/git-checkout.txt           | 16 +++++------
 Documentation/git-diff-index.txt         |  4 +--
 Documentation/git-diff-tree.txt          | 14 +++++-----
 Documentation/git-ls-files.txt           |  6 ++--
 Documentation/git-ls-tree.txt            |  6 ++--
 Documentation/git-read-tree.txt          | 10 +++----
 Documentation/git-rebase.txt             |  2 +-
 Documentation/git-reset.txt              | 16 +++++------
 Documentation/git-rev-parse.txt          |  2 +-
 Documentation/git-svn.txt                |  6 ++--
 Documentation/git-tar-tree.txt           |  4 +--
 Documentation/git.txt                    |  8 +++---
 Documentation/gitcli.txt                 |  2 +-
 Documentation/gittutorial-2.txt          |  2 +-
 Documentation/glossary-content.txt       | 47 ++++++++++++++++++++++++++------
 Documentation/revisions.txt              | 14 ++++++----
 archive.c                                |  6 ++--
 builtin/checkout.c                       |  6 ++--
 builtin/diff-index.c                     |  2 +-
 builtin/diff-tree.c                      |  2 +-
 builtin/diff.c                           |  2 +-
 builtin/ls-files.c                       |  8 +++---
 builtin/ls-tree.c                        |  2 +-
 builtin/read-tree.c                      |  2 +-
 builtin/reset.c                          |  4 +--
 builtin/revert.c                         |  4 +--
 builtin/tar-tree.c                       | 12 ++++----
 contrib/examples/git-checkout.sh         | 10 +++----
 contrib/examples/git-reset.sh            |  2 +-
 contrib/examples/git-revert.sh           |  4 +--
 fast-import.c                            |  2 +-
 git-svn.perl                             |  6 ++--
 gitweb/gitweb.perl                       |  4 +--
 po/de.po                                 | 20 +++++++-------
 po/fr.po                                 | 20 +++++++-------
 po/git.pot                               | 20 +++++++-------
 po/sv.po                                 | 20 +++++++-------
 po/vi.po                                 | 41 ++++++++++++++--------------
 po/zh_CN.po                              | 20 +++++++-------
 remote.c                                 |  2 +-
 t/t1512-rev-parse-disambiguation.sh      | 26 +++++++++---------
 t/t2010-checkout-ambiguous.sh            |  2 +-
 t/t4100/t-apply-3.patch                  |  8 +++---
 t/t4100/t-apply-7.patch                  |  8 +++---
 t/t9300-fast-import.sh                   |  2 +-
 t/t9500-gitweb-standalone-no-errors.sh   |  2 +-
 t/t9501-gitweb-standalone-http-status.sh |  8 +++---
 54 files changed, 247 insertions(+), 213 deletions(-)
-- 
1.8.4
Next: Richard Hansen
Message 1 of 18 in “documentation cleanups for <rev>^{<type>}”
  1. 0/7 documentation cleanups for <rev>^{<type>}Richard Hansen, Sep 2, 2013
  2. 1/7 glossary: mention 'treeish' as an alternative to 'tree-ish'Richard Hansen, Sep 2, 2013
  3. Junio C HamanoSep 3, 2013
  4. 0/7 documentation cleanups for <rev>^{<type>}Richard Hansen, Sep 4, 2013
  5. 1/7 glossary: mention 'treeish' as an alternative to 'tree-ish'Richard Hansen, Sep 4, 2013
  6. 2/7 glossary: define commit-ish (a.k.a. committish)Richard Hansen, Sep 4, 2013
  7. 3/7 use 'tree-ish' instead of 'treeish'Richard Hansen, Sep 4, 2013
  8. 4/7 use 'commit-ish' instead of 'committish'Richard Hansen, Sep 4, 2013
  9. 5/7 glossary: more precise definition of tree-ish (a.k.a. treeish)Richard Hansen, Sep 4, 2013
  10. 6/7 revisions.txt: fix and clarify <rev>^{<type>}Richard Hansen, Sep 4, 2013
  11. 7/7 glossary: fix and clarify the definition of 'ref'Richard Hansen, Sep 4, 2013
  12. Junio C HamanoSep 4, 2013
  13. 2/7 glossary: define committish (a.k.a. commit-ish)Richard Hansen, Sep 2, 2013
  14. 3/7 use 'treeish' instead of 'tree-ish'Richard Hansen, Sep 2, 2013
  15. 4/7 use 'committish' instead of 'commit-ish'Richard Hansen, Sep 2, 2013
  16. 5/7 glossary: more precise definition of treeish (a.k.a. tree-ish)Richard Hansen, Sep 2, 2013
  17. 6/7 revisions.txt: fix and clarify <rev>^{<type>}Richard Hansen, Sep 2, 2013
  18. 7/7 glossary: fix and clarify the definition of 'ref'Richard Hansen, Sep 2, 2013

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.