короткий ответ (TL;DR)

"Tree-ish" - это термин, который относится к любому идентификатору (как указано в ЖКТ редакция документации), что в конечном итоге приводит к каталогу (sub) дерево (git относится к каталогам как "деревья"и" объекты дерева").

в случае оригинального плаката,foo каталог что он хочет указывать. Правильный способ указать (sub)каталог в Git-использовать это "дерево-иш" синтаксис (пункт #15 от изменения в Git документация):

<rev>:<path>, например,HEAD:README, :README, master:./README

суффикс : после этого путь называет blob или дерево на данном пути в объект tree-ish, названный частью перед двоеточием.

другими словами, master:foo это правильный синтаксис, а не master/foo.

другое " дерево-иш "(плюс Commit-ish)

здесь полный список идентификаторов commit-ish и tree-ish (от ЖКТ редакция документации, спасибо LopSae для указания его вон!--30-->):

----------------------------------------------------------------------
|    Commit-ish/Tree-ish    |                Examples
----------------------------------------------------------------------
|  1. <sha1>                | dae86e1950b1277e545cee180551750029cfe735
|  2. <describeOutput>      | v1.7.4.2-679-g3bee7fb
|  3. <refname>             | master, heads/master, refs/heads/master
|  4. <refname>@{<date>}    | master@{yesterday}, HEAD@{5 minutes ago}
|  5. <refname>@{<n>}       | master@{1}
|  6. @{<n>}                | @{1}
|  7. @{-<n>}               | @{-1}
|  8. <refname>@{upstream}  | master@{upstream}, @{u}
|  9. <rev>^                | HEAD^, v1.5.1^0
| 10. <rev>~<n>             | master~3
| 11. <rev>^{<type>}        | v0.99.8^{commit}
| 12. <rev>^{}              | v0.99.8^{}
| 13. <rev>^{/<text>}       | HEAD^{/fix nasty bug}
| 14. :/<text>              | :/fix nasty bug
----------------------------------------------------------------------
|       Tree-ish only       |                Examples
----------------------------------------------------------------------
| 15. <rev>:<path>          | HEAD:README, :README, master:./README
----------------------------------------------------------------------
|         Tree-ish?         |                Examples
----------------------------------------------------------------------
| 16. :<n>:<path>           | :0:README, :README
----------------------------------------------------------------------

идентификаторы #1-14 - это все "commit-ish", потому что все они приводят к коммитам, но поскольку коммиты также указывают на деревья каталогов, все они в конечном итоге приводят к (sub)объекты дерева каталогов, и поэтому может также использоваться как "дерево иш".

#15 также может использоваться как дерево, когда оно относится к (sub)каталог, но это может также использоваться для идентификации конкретных файлов. Когда речь идет о файлах, я не конечно, если это все еще считается "дерево-иш", или если действует больше как "blob-ish" (Git относится к файлам, как "кляксы").

Длинный Ответ

на самых низких уровнях Git отслеживает исходный код, используя четыре основных объекты:

1. аннотированные теги, которые указывают на коммиты.
2. Commits, которые указывают на корневое дерево каталогов вашего проект.
3. деревья, которые являются каталогами и подкаталогами.
4. Blobs, которые являются файлами.

каждый из этих объектов имеет свой собственный хэш-идентификатор sha1, так как Линус Торвальдс разработал Git как контент - адресно - файловая система, т. е. файлы могут быть получены на основе их содержимого (идентификаторы sha1 генерируются из содержимого файла). Pro Git книга дает в этом примере схемы:

много Команды Git могут принимать специальные идентификаторы для коммитов и (sub)каталога деревья:

• "Commit-ish" - это идентификаторы, которые в конечном итоге приводят к объекту commit. Например,

  tag -> commit

• "Tree-ish" - это идентификаторы, которые в конечном итоге приводят к объектам дерева (т. е. каталога).

  tag -> commit -> project-root-directory

потому что объекты фиксации всегда указывают на объект дерева каталогов ( корень каталог вашего проекта), любой идентификатор, который является "commit-ish", определение "дерево-иш". Другими словами,любой идентификатор, который приводит к объект commit также может использоваться для приведения к объекту дерева каталогов (sub).

но поскольку объекты дерева каталогов никогда не указывают на коммиты в управлении версиями Git система, не каждый идентификатор, который указывает на (под)дерево каталогов также может быть используется для фиксации. Другими словами,набор идентификаторы "commit-ish" является строгим подмножеством набора идентификаторов" tree-ish".

как поясняется в документация ( спасибо Требору за помощь мне найти его):

<tree>

указывает имя объекта дерева.

<commit>

указывает имя объекта фиксации.

<tree-ish>

указывает имя объекта дерева, фиксации или тега. Команда, которая принимает <tree-ish> аргумент в конечном счете хочет оперировать на <tree> объект, но автоматически разыменования <commit> и <tag> объекты, которые указывают на <tree>.

<commit-ish>

указывает имя объекта фиксации или тега. Команда, которая принимает <commit-ish> аргумент в конечном счете хочет работать на <commit> объект, но автоматически разыменования <tag> объекты, которые указывают на <commit>.

набор идентификаторов дерева, которые не может использоваться как commit-ish are

1. <rev>:<path>, что приводит напрямую для деревьев каталогов, не фиксировать объекты. Например, HEAD:subdirectory.

2. в SHA1 идентификаторы дерево каталогов объекты.