1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>gitignore(
5)
</title>
312 gitignore(
5) Manual Page
315 <div class=
"sectionbody">
317 Specifies intentionally untracked files to ignore
322 <div class=
"sectionbody">
323 <div class=
"para"><p>$GIT_DIR/info/exclude, .gitignore
</p></div>
325 <h2 id=
"_description">DESCRIPTION
</h2>
326 <div class=
"sectionbody">
327 <div class=
"para"><p>A
<tt>gitignore
</tt> file specifies intentionally untracked files that
329 Note that all the
<tt>gitignore
</tt> files really concern only files
330 that are not already tracked by git;
331 in order to ignore uncommitted changes in already tracked files,
332 please refer to the
<em>git update-index --assume-unchanged
</em>
333 documentation.
</p></div>
334 <div class=
"para"><p>Each line in a
<tt>gitignore
</tt> file specifies a pattern.
335 When deciding whether to ignore a path, git normally checks
336 <tt>gitignore
</tt> patterns from multiple sources, with the following
337 order of precedence, from highest to lowest (within one level of
338 precedence, the last matching pattern decides the outcome):
</p></div>
339 <div class=
"ilist"><ul>
342 Patterns read from the command line for those commands that support
348 Patterns read from a
<tt>.gitignore
</tt> file in the same directory
349 as the path, or in any parent directory, with patterns in the
350 higher level files (up to the toplevel of the work tree) being overridden
351 by those in lower level files down to the directory containing the file.
352 These patterns match relative to the location of the
353 <tt>.gitignore
</tt> file. A project normally includes such
354 <tt>.gitignore
</tt> files in its repository, containing patterns for
355 files generated as part of the project build.
360 Patterns read from
<tt>$GIT_DIR/info/exclude
</tt>.
365 Patterns read from the file specified by the configuration
366 variable
<em>core.excludesfile
</em>.
370 <div class=
"para"><p>Which file to place a pattern in depends on how the pattern is meant to
371 be used. Patterns which should be version-controlled and distributed to
372 other repositories via clone (i.e., files that all developers will want
373 to ignore) should go into a
<tt>.gitignore
</tt> file. Patterns which are
374 specific to a particular repository but which do not need to be shared
375 with other related repositories (e.g., auxiliary files that live inside
376 the repository but are specific to one user's workflow) should go into
377 the
<tt>$GIT_DIR/info/exclude
</tt> file. Patterns which a user wants git to
378 ignore in all situations (e.g., backup or temporary files generated by
379 the user's editor of choice) generally go into a file specified by
380 <tt>core.excludesfile
</tt> in the user's
<tt>~/.gitconfig
</tt>.
</p></div>
381 <div class=
"para"><p>The underlying git plumbing tools, such as
382 <em>git-ls-files
</em> and
<em>git-read-tree
</em>, read
383 <tt>gitignore
</tt> patterns specified by command-line options, or from
384 files specified by command-line options. Higher-level git
385 tools, such as
<em>git-status
</em> and
<em>git-add
</em>,
386 use patterns from the sources specified above.
</p></div>
387 <div class=
"para"><p>Patterns have the following format:
</p></div>
388 <div class=
"ilist"><ul>
391 A blank line matches no files, so it can serve as a separator
397 A line starting with # serves as a comment.
402 An optional prefix
<em>!
</em> which negates the pattern; any
403 matching file excluded by a previous pattern will become
404 included again. If a negated pattern matches, this will
405 override lower precedence patterns sources.
410 If the pattern ends with a slash, it is removed for the
411 purpose of the following description, but it would only find
412 a match with a directory. In other words,
<tt>foo/
</tt> will match a
413 directory
<tt>foo
</tt> and paths underneath it, but will not match a
414 regular file or a symbolic link
<tt>foo
</tt> (this is consistent
415 with the way how pathspec works in general in git).
420 If the pattern does not contain a slash
<em>/
</em>, git treats it as
421 a shell glob pattern and checks for a match against the
422 pathname without leading directories.
427 Otherwise, git treats the pattern as a shell glob suitable
428 for consumption by fnmatch(
3) with the FNM_PATHNAME flag:
429 wildcards in the pattern will not match a / in the pathname.
430 For example,
"Documentation/*.html" matches
431 "Documentation/git.html" but not
432 "Documentation/ppc/ppc.html". A leading slash matches the
433 beginning of the pathname; for example,
"/*.c" matches
434 "cat-file.c" but not
"mozilla-sha1/sha1.c".
438 <div class=
"para"><p>An example:
</p></div>
439 <div class=
"listingblock">
440 <div class=
"content">
441 <pre><tt> $ git status
445 # Documentation/foo.html
446 # Documentation/gitignore.html
451 $ cat .git/info/exclude
452 # ignore objects and archives, anywhere in the tree.
454 $ cat Documentation/.gitignore
455 # ignore generated html files,
457 # except foo.html which is maintained by hand
463 # Documentation/foo.html
466 <div class=
"para"><p>Another example:
</p></div>
467 <div class=
"listingblock">
468 <div class=
"content">
469 <pre><tt> $ cat .gitignore
471 $ ls arch/foo/kernel/vm*
472 arch/foo/kernel/vmlinux.lds.S
473 $ echo '!/vmlinux*'
>arch/foo/kernel/.gitignore
</tt></pre>
475 <div class=
"para"><p>The second .gitignore prevents git from ignoring
476 <tt>arch/foo/kernel/vmlinux.lds.S
</tt>.
</p></div>
478 <h2 id=
"_documentation">Documentation
</h2>
479 <div class=
"sectionbody">
480 <div class=
"para"><p>Documentation by David Greaves, Junio C Hamano, Josh Triplett,
481 Frank Lichtenheld, and the git-list
<git@vger.kernel.org
>.
</p></div>
483 <h2 id=
"_git">GIT
</h2>
484 <div class=
"sectionbody">
485 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
488 <div id=
"footer-text">
489 Last updated
2009-
04-
08 07:
36:
13 UTC