.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-CONFIG" "1" "05/21/2007" "Git 1.5.2.24.g93d4" "Git Manual"
+.TH "GIT\-CONFIG" "1" "05/22/2007" "Git 1.5.2.35.ga334" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
Common unit suffixes of \fIk\fR, \fIm\fR, or \fIg\fR are supported.
.TP
+core.excludeFile
+In addition to \fI.gitignore\fR (per\-directory) and \fI.git/info/exclude\fR, git looks into this file for patterns of files which are not meant to be tracked.
+.TP
alias.*
Command aliases for the \fBgit\fR(1) command wrapper \- e.g. after defining "alias.last = cat\-file commit HEAD", the invocation "git last" is equivalent to "git cat\-file commit HEAD". To avoid confusion and troubles with script usage, aliases that hide existing git commands are ignored. Arguments are split by spaces, the usual shell quoting and escaping is supported. quote pair and a backslash can be used to quote them.
.sp
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-DESCRIBE" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual"
+.TH "GIT\-DESCRIBE" "1" "05/22/2007" "Git 1.5.2.35.ga334" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.SH "NAME"
git\-describe \- Show the most recent tag that is reachable from a commit
.SH "SYNOPSIS"
-\fIgit\-describe\fR [\-\-all] [\-\-tags] [\-\-abbrev=<n>] <committish>\&...
+\fIgit\-describe\fR [\-\-all] [\-\-tags] [\-\-contains] [\-\-abbrev=<n>] <committish>\&...
.SH "DESCRIPTION"
The command finds the most recent tag that is reachable from a commit, and if the commit itself is pointed at by the tag, shows the tag. Otherwise, it suffixes the tag name with the number of additional commits and the abbreviated object name of the commit.
.SH "OPTIONS"
\-\-tags
Instead of using only the annotated tags, use any tag found in .git/refs/tags.
.TP
+\-\-contains
+Instead of finding the tag that predates the commit, find the tag that comes after the commit, and thus contains it. Automatically implies \-\-tags.
+.TP
\-\-abbrev=<n>
Instead of using the default 8 hexadecimal digits as the abbreviated object name, use <n> digits.
.TP
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-NAME\-REV" "1" "05/19/2007" "Git 1.5.2.rc3.87.g404f" "Git Manual"
+.TH "GIT\-NAME\-REV" "1" "05/22/2007" "Git 1.5.2.35.ga334" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.TP
\-\-stdin
Read from stdin, append "(<rev_name>)" to all sha1's of nameable commits, and pass to stdout
+.TP
+\-\-name\-only
+Instead of printing both the SHA\-1 and the name, print only the name. If given with \-\-tags the usual tag prefix of "tags/" is also ommitted from the name, matching the output of \fB:git\-describe\fR(1) more closely. This option cannot be combined with \-\-stdin.
.SH "EXAMPLE"
Given a commit, find out where it is relative to the local refs. Say somebody wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a. Of course, you look into the commit, but that only tells you what happened, but not the context.
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-STATUS" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual"
+.TH "GIT\-STATUS" "1" "05/22/2007" "Git 1.5.2.35.ga334" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
The output from this command is designed to be used as a commit template comments, and all the output lines are prefixed with \fI#\fR.
.SH "CONFIGURATION"
The command honors color.status (or status.color \(em they mean the same thing and the latter is kept for backward compatibility) and color.status.<slot> configuration variables to colorize its output.
+
+As for \fBgit\-add\fR(1), the configuration variable \fIcore.excludesfile\fR can indicate a path to a file containing patterns of file names to exclude, in addition to patterns given in \fIinfo/exclude\fR and \fI.gitignore\fR.
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>.
.SH "DOCUMENTATION"