From: Junio C Hamano Date: Tue, 14 Feb 2006 08:00:34 +0000 (+0000) Subject: Autogenerated man pages for v1.2.0-g6a9b X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=821ca755eeaa67008bf4063dc36ba3c8b93afed8;p=git.git Autogenerated man pages for v1.2.0-g6a9b --- diff --git a/man1/git-commit.1 b/man1/git-commit.1 index 840076270..8dc04903b 100755 --- a/man1/git-commit.1 +++ b/man1/git-commit.1 @@ -23,8 +23,8 @@ git-commit \- Record your changes .SH "SYNOPSIS" .nf -\fIgit\-commit\fR [\-a] [\-i] [\-s] [\-v] [(\-c | \-C) | \-F | \-m ] - [\-e] [\-\-author ] [\-\-] ... +\fIgit\-commit\fR [\-a] [\-s] [\-v] [(\-c | \-C) | \-F | \-m ] + [\-e] [\-\-author ] [\-\-] [[\-i | \-o ]...] .fi .SH "DESCRIPTION" @@ -77,13 +77,17 @@ The message taken from file with \-F, command line with \-m, and from file with \-i|\-\-include Instead of committing only the files specified on the command line, update them in the index file and then commit the whole index\&. This is the traditional behaviour\&. +.TP +\-o|\-\-only +Commit only the files specified on the command line\&. This format cannot be used during a merge, nor when the index and the latest commit does not match on the specified paths to avoid confusion\&. + .TP -- Do not interpret any more arguments as options\&. .TP ... -Commit only the files specified on the command line\&. This format cannot be used during a merge, nor when the index and the latest commit does not match on the specified paths to avoid confusion\&. +Files to be committed\&. The meaning of these is different between \-\-include and \-\-only\&. Without either, it defaults \-\-only semantics\&. If you make a commit and then found a mistake immediately after that, you can recover from it with \fBgit\-reset\fR(1)\&. diff --git a/man1/git-ls-files.1 b/man1/git-ls-files.1 index 516f8367e..109e73b1b 100755 --- a/man1/git-ls-files.1 +++ b/man1/git-ls-files.1 @@ -23,7 +23,7 @@ git-ls-files \- Information about files in the index/working directory .SH "SYNOPSIS" -git\-ls\-files [\-z] [\-t] (\-\-[cached|deleted|others|ignored|stage|unmerged|killed|modified])* (\-[c|d|o|i|s|u|k|m])* [\-x |\-\-exclude=] [\-X |\-\-exclude\-from=] [\-\-exclude\-per\-directory=] [\-\-full\-name] [\-\-] []* +\fIgit\-ls\-files\fR [\-z] [\-t] (\-\-[cached|deleted|others|ignored|stage|unmerged|killed|modified])* (\-[c|d|o|i|s|u|k|m])* [\-x |\-\-exclude=] [\-X |\-\-exclude\-from=] [\-\-exclude\-per\-directory=] [\-\-full\-name] [\-\-] []* .SH "DESCRIPTION" @@ -91,15 +91,29 @@ read additional exclude patterns that apply only to the directory and its subdir \-t Identify the file status with the following tags (followed by a space) at the start of each line: H + cached + M + unmerged + R + removed/deleted + C + modified/changed + K -to be killed ? other + +to be killed + +? + +other + .TP \-\-full\-name @@ -116,7 +130,7 @@ Files to show\&. If no files are given all files which match the other specified .SH "OUTPUT" -show files just outputs the filename unless \-\-stage is specified in which case it outputs: +show files just outputs the filename unless \fI\-\-stage\fR is specified in which case it outputs: .nf [ ] @@ -134,7 +148,7 @@ When \-z option is not used, TAB, LF, and backslash characters in pathnames are .SH "EXCLUDE PATTERNS" -git\-ls\-files can use a list of "exclude patterns" when traversing the directory tree and finding files to show when the flags \-\-others or \-\-ignored are specified\&. +\fIgit\-ls\-files\fR can use a list of "exclude patterns" when traversing the directory tree and finding files to show when the flags \-\-others or \-\-ignored are specified\&. These exclude patterns come from these places: @@ -147,11 +161,11 @@ command line flag \-\-exclude= specifies a single pattern\&. command line flag \-\-exclude\-from= specifies a list of patterns stored in a file\&. .TP 3. -command line flag \-\-exclude\-per\-directory= specifies a name of the file in each directory git\-ls\-files examines, and if exists, its contents are used as an additional list of patterns\&. +command line flag \-\-exclude\-per\-directory= specifies a name of the file in each directory \fIgit\-ls\-files\fR examines, and if exists, its contents are used as an additional list of patterns\&. .LP -An exclude pattern file used by (2) and (3) contains one pattern per line\&. A line that starts with a # can be used as comment for readability\&. +An exclude pattern file used by (2) and (3) contains one pattern per line\&. A line that starts with a \fI#\fR can be used as comment for readability\&. There are three lists of patterns that are in effect at a given time\&. They are built and ordered in the following way: @@ -178,10 +192,10 @@ An exclude pattern is of the following format: .TP 3 \(bu -an optional prefix ! which means that the fate this pattern specifies is "include", not the usual "exclude"; the remainder of the pattern string is interpreted according to the following rules\&. +an optional prefix \fI!\fR which means that the fate this pattern specifies is "include", not the usual "exclude"; the remainder of the pattern string is interpreted according to the following rules\&. .TP \(bu -if it does not contain a slash /, it is a shell glob pattern and used to match against the filename without leading directories (i\&.e\&. the same way as the current implementation)\&. +if it does not contain a slash \fI/\fR, it is a shell glob pattern and used to match against the filename without leading directories (i\&.e\&. the same way as the current implementation)\&. .TP \(bu otherwise, it is a shell glob pattern, suitable for consumption by fnmatch(3) with FNM_PATHNAME flag\&. I\&.e\&. a slash in the pattern must match a slash in the pathname\&. "Documentation/*\&.html" matches "Documentation/git\&.html" but not "ppc/ppc\&.html"\&. As a natural exception, "/*\&.c" matches "cat\-file\&.c" but not "mozilla\-sha1/sha1\&.c"\&.