Doc: separate gitignore pattern sources

Use separate bulleted paragraphs for the three different gitignore
pattern sources.

Signed-off-by: Philip Oakley <philipoakley@iee.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Philip Oakley 2012-09-19 00:25:31 +01:00 committed by Junio C Hamano
parent bc40deabbc
commit 3f8c5a41f1
1 changed files with 18 additions and 12 deletions

View File

@ -41,18 +41,24 @@ precedence, the last matching pattern decides the outcome):
variable 'core.excludesfile'. variable 'core.excludesfile'.


Which file to place a pattern in depends on how the pattern is meant to Which file to place a pattern in depends on how the pattern is meant to
be used. Patterns which should be version-controlled and distributed to be used.
other repositories via clone (i.e., files that all developers will want
to ignore) should go into a `.gitignore` file. Patterns which are * Patterns which should be version-controlled and distributed to
specific to a particular repository but which do not need to be shared other repositories via clone (i.e., files that all developers will want
with other related repositories (e.g., auxiliary files that live inside to ignore) should go into a `.gitignore` file.
the repository but are specific to one user's workflow) should go into
the `$GIT_DIR/info/exclude` file. Patterns which a user wants git to * Patterns which are
ignore in all situations (e.g., backup or temporary files generated by specific to a particular repository but which do not need to be shared
the user's editor of choice) generally go into a file specified by with other related repositories (e.g., auxiliary files that live inside
`core.excludesfile` in the user's `~/.gitconfig`. Its default value is the repository but are specific to one user's workflow) should go into
$XDG_CONFIG_HOME/git/ignore. If $XDG_CONFIG_HOME is either not set or empty, the `$GIT_DIR/info/exclude` file.
$HOME/.config/git/ignore is used instead.
* Patterns which a user wants git to
ignore in all situations (e.g., backup or temporary files generated by
the user's editor of choice) generally go into a file specified by
`core.excludesfile` in the user's `~/.gitconfig`. Its default value is
$XDG_CONFIG_HOME/git/ignore. If $XDG_CONFIG_HOME is either not set or
empty, $HOME/.config/git/ignore is used instead.


The underlying git plumbing tools, such as The underlying git plumbing tools, such as
'git ls-files' and 'git read-tree', read 'git ls-files' and 'git read-tree', read