Re: [RFD] Place to document magic pathspecs like ":/" and pathspec handling

From: Jakub Narębski <jnareb@gmail.com>
Date: Jun 29, 2016, 21:22 UTC
Message-ID: <57743BFB.9040709@gmail.com>
In-Reply-To: <CAPc5daVqjhWrJjNX6monHdMTRwimbjz==j9B2FS-nXNCqPDCYQ@mail.gmail.com>

W dniu 2016-06-29 o 21:51, Junio C Hamano pisze:

Show 8 quoted lines

> On Wed, Jun 29, 2016 at 12:47 PM, Jakub Narębski <jnareb@gmail.com> wrote:
>> I have noticed that the magic pathspec ":/" is described only in RelNotes
>> for revision 1.7.6:
>> |I think the reason might be that there was no good place to put that
>> information in.  Nowadays we have gitcli(7) manual page, but perhaps
> $ git help glossary
>
> look for pathspec.

Thanks. I haven't noticed that.

But I think it is not the best place to keep this documentation. There are the following issues with it:

* it is hard to find; I did not search _glossary_ for information
  about how Git handles pathspecs, I would search it if I didn't know
  what pathspec means.

* it is longest entry in glossary, and the only one with nested
  list, but

* it is also too short to describe how Git handles pathspecs in detail,
  and a bit cryptic; there are no examples (so grepping docs for '":/"'
  didn't found it).

-- 
Jakub Narębski