Re: [PATCH v3] Add an explicit GIT_DIR to the list of excludes

From: Jakub Narębski <jnareb@gmail.com>
Date: May 29, 2014, 10:34 UTC
Message-ID: <CANQwDwfC93uG7+mv0XpxuRWQP+yGS0F94OHk7AUcy_WfQ7VtQQ@mail.gmail.com>
In-Reply-To: <CAKpPgvcMJCYS9jfq+XhfZzT6w4RgBvMypqo2BsAWK2XYt2BPBg@mail.gmail.com>

On Thu, May 29, 2014 at 4:33 AM, Pasha Bolokhov <pasha.bolokhov@gmail.com> wrote:

>
> Agree, but "partial" here means... what? just a little doc?

I'm sorry, I tried to be cute and failed :$

This is not official name for documentation files that are meant for inclusion
and not as standalone manpages.  I think they are similar to 'partial templates'
http://guides.rubyonrails.org/layouts_and_rendering.html#using-partials
- usually just called "partials" - hence my use of this name.

Example: date-formats.txt included in git-commit(1), git-commit-tree(1)
and git-tag(1).

> On Wed, May 28, 2014 at 11:53 AM, Jakub Narębski <jnareb@gmail.com> wrote:
>> W dniu 2014-05-27 19:16, Pasha Bolokhov pisze:

[...]

Show 12 quoted lines

>>>      I suggest this. There appears to be a notion of "standard
>>> excludes" both in the code (dir.c) and in the man pages (git-grep,
>>> git-ls-files). However, it doesn't actually appear to be defined
>>> strictly speaking. So my suggestion is to define those "standard
>>> excludes" in one place (say "gitignore(5)"), and make other man pages
>>> (git-config, git-grip, git-ls-files) have references to that place
>>> instead of explaining every time in detail what is being excluded.
>>
>>
>> Or define those "standard excludes" in standard-excludes.txt "partial",
>> and include said file from git-grep(1), git-ls-files(1), and perhaps
>> gitignore(5).

-- 
Jakub Narębski