From: Richard Hansen Date: Wed, 4 Sep 2013 19:04:32 +0000 (-0400) Subject: glossary: more precise definition of tree-ish (a.k.a. treeish) X-Git-Tag: v1.8.5-rc0~123^2~2 X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/930f302cdbdd8410188fe306341117cd10af3383?ds=inline;hp=--cc glossary: more precise definition of tree-ish (a.k.a. treeish) A tree-ish isn't a ref. Also, mention dereferencing, and that a commit dereferences to a tree, to support gitrevisions(7) and rev-parse's error messages. Signed-off-by: Richard Hansen Signed-off-by: Junio C Hamano --- 930f302cdbdd8410188fe306341117cd10af3383 diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt index 47e901ece8..3466ce9129 100644 --- a/Documentation/glossary-content.txt +++ b/Documentation/glossary-content.txt @@ -499,9 +499,18 @@ should not be combined with other pathspec. <> is equivalent to a <>. [[def_tree-ish]]tree-ish (also treeish):: - A <> pointing to either a <>, a <>, or a <> pointing to a tag or commit or tree object. + A <> or an <> + that can be recursively dereferenced to a tree object. + Dereferencing a <> yields the + tree object corresponding to the <>'s + top <>. + The following are all tree-ishes: + a <>, + a tree object, + a <> that points to a tree object, + a tag object that points to a tag object that points to a tree + object, + etc. [[def_unmerged_index]]unmerged index:: An <> which contains unmerged