Re: [PATCH/RFC 09/12] docs: use <commit> instead of <commit-ish>

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Mark Lodato <lodatom@xxxxxxxxx> writes:

> There exist no commands that accept a <commit> but not a <commit-ish>,

I have one worry about this and [07/12].  The droppage of -ish would make
sense from the point of view of describing command line arguments,
i.e. what you can give to the commands, but it would make it impossible
for us to talk about places that _only_ tree not arbitrary tree-ish can
appear.  For example, don't we ever talk about something like this?

    A tree object is a sequence of records, each of which describes the
    type of entry, object name, and the name of the entry in the tree.
    When the type is "tree", the object name must name a tree, when the
    type is "gitlink", the object name must name a commit, ...

Other than that small worry, I think the series goes in the right
direction.
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]