From 0d96f48ed979889f5a010de14aff53e4200bdf04 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Fri, 27 Apr 2007 08:22:24 +0000 Subject: [PATCH] Autogenerated manpages for v1.5.2-rc0-71-g4342 --- man1/git-annotate.1 | 23 ++++++++++++++++++++--- man1/git-blame.1 | 23 ++++++++++++++++++++--- man1/git-diff-files.1 | 6 +++--- man1/git-fetch.1 | 10 ++++++++-- man1/git-fmt-merge-msg.1 | 18 ++++++++++++++++-- man1/git-grep.1 | 20 +++++++++++++++----- man1/git-http-fetch.1 | 5 ++++- man1/git-http-push.1 | 20 +++++++++++++++++--- man1/git-local-fetch.1 | 14 +++++++++++++- man1/git-pull.1 | 10 ++++++++-- 10 files changed, 124 insertions(+), 25 deletions(-) diff --git a/man1/git-annotate.1 b/man1/git-annotate.1 index e4e8f3f34..ee6880755 100644 --- a/man1/git-annotate.1 +++ b/man1/git-annotate.1 @@ -2,7 +2,7 @@ .\" 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\-ANNOTATE" "1" "04/22/2007" "Git 1.5.1.1.135.gf948" "Git Manual" +.TH "GIT\-ANNOTATE" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -24,8 +24,25 @@ Do not treat root commits as boundaries. This can also be controlled via the bla \-\-show\-stats Include additional statistics at the end of blame output. .TP -\-L n,m -Annotate only the specified line range (lines count from 1). +\-L , +Annotate only the given line range. and can take one of these forms: +.RS +.TP 3 +\(bu +number + +If or is a number, it specifies an absolute line number (lines count from 1). +.TP +\(bu +/regex/ + +This form will use the first line matching the given POSIX regex. If is a regex, it will search starting at the line given by . +.TP +\(bu ++offset or \-offset + +This is only valid for and will specify a number of lines before or after the line given by . +.RE .TP \-l Show long rev (Default: off). diff --git a/man1/git-blame.1 b/man1/git-blame.1 index af314d0ff..6c015ce33 100644 --- a/man1/git-blame.1 +++ b/man1/git-blame.1 @@ -2,7 +2,7 @@ .\" 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\-BLAME" "1" "04/22/2007" "Git 1.5.1.1.135.gf948" "Git Manual" +.TH "GIT\-BLAME" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -41,8 +41,25 @@ Do not treat root commits as boundaries. This can also be controlled via the bla \-\-show\-stats Include additional statistics at the end of blame output. .TP -\-L n,m -Annotate only the specified line range (lines count from 1). +\-L , +Annotate only the given line range. and can take one of these forms: +.RS +.TP 3 +\(bu +number + +If or is a number, it specifies an absolute line number (lines count from 1). +.TP +\(bu +/regex/ + +This form will use the first line matching the given POSIX regex. If is a regex, it will search starting at the line given by . +.TP +\(bu ++offset or \-offset + +This is only valid for and will specify a number of lines before or after the line given by . +.RE .TP \-l Show long rev (Default: off). diff --git a/man1/git-diff-files.1 b/man1/git-diff-files.1 index 18a3b0c08..2ba7697be 100644 --- a/man1/git-diff-files.1 +++ b/man1/git-diff-files.1 @@ -2,7 +2,7 @@ .\" 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\-DIFF\-FILES" "1" "04/22/2007" "" "" +.TH "GIT\-DIFF\-FILES" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -10,7 +10,7 @@ .SH "NAME" git\-diff\-files \- Compares files in the working tree and the index .SH "SYNOPSIS" -\fIgit\-diff\-files\fR [\-q] [\-0|\-1|\-2|\-3|\-c|\-\-cc|\-n|\-\-no\-index] [] [\&...] +\fIgit\-diff\-files\fR [\-q] [\-0|\-1|\-2|\-3|\-c|\-\-cc|\-\-no\-index] [] [\&...] .SH "DESCRIPTION" Compares the files in the working tree and the index. When paths are specified, compares only those named paths. Otherwise all entries in the index are compared. The output format is the same as "git\-diff\-index" and "git\-diff\-tree". .SH "OPTIONS" @@ -145,7 +145,7 @@ The default is to diff against our branch (\-2) and the cleanly resolved paths. \-c,\-\-cc This compares stage 2 (our branch), stage 3 (their branch) and the working tree file and outputs a combined diff, similar to the way \fIdiff\-tree\fR shows a merge commit with these flags. .TP -\\\-n,\-\-no\-index +\-\-no\-index Compare the two given files / directories. .TP \-q diff --git a/man1/git-fetch.1 b/man1/git-fetch.1 index 214e447ec..69baab418 100644 --- a/man1/git-fetch.1 +++ b/man1/git-fetch.1 @@ -2,7 +2,7 @@ .\" 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\-FETCH" "1" "04/22/2007" "" "" +.TH "GIT\-FETCH" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -19,6 +19,12 @@ The ref names and their object names of fetched refs are stored in .git/FETCH_HE When stores the fetched result in tracking branches, the tags that point at these branches are automatically followed. This is done by first fetching from the remote using the given s, and if the repository has objects that are pointed by remote tags that it does not yet have, then fetch those missing tags. If the other end has tags that point at branches you are not interested in, you will not get them. .SH "OPTIONS" .TP +\-q, \-\-quiet +Pass \-\-quiet to git\-fetch\-pack and silence any other internally used programs. +.TP +\-v, \-\-verbose +Be verbose. +.TP \-a, \-\-append Append ref names and object names of fetched refs to the existing contents of .git/FETCH_HEAD. Without this option old data in .git/FETCH_HEAD will be overwritten. .TP @@ -28,7 +34,7 @@ When given, and the repository to fetch from is handled by \fIgit\-fetch\-pack\f \-f, \-\-force When git\-fetch is used with : refspec, it refuses to update the local branch unless the remote branch it fetches is a descendant of . This option overrides that check. .TP -\-\-no\-tags +\-n, \-\-no\-tags By default, git\-fetch fetches tags that point at objects that are downloaded from the remote repository and stores them locally. This option disables this automatic tag following. .TP \-t, \-\-tags diff --git a/man1/git-fmt-merge-msg.1 b/man1/git-fmt-merge-msg.1 index 8722265ba..b5113c9be 100644 --- a/man1/git-fmt-merge-msg.1 +++ b/man1/git-fmt-merge-msg.1 @@ -2,7 +2,7 @@ .\" 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\-FMT\-MERGE\-MSG" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual" +.TH "GIT\-FMT\-MERGE\-MSG" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -10,11 +10,25 @@ .SH "NAME" git\-fmt\-merge\-msg \- Produce a merge commit message .SH "SYNOPSIS" -\fIgit\-fmt\-merge\-msg\fR <$GIT_DIR/FETCH_HEAD +git\-fmt\-merge\-msg [\-\-summary | \-\-no\-summary] <$GIT_DIR/FETCH_HEAD git\-fmt\-merge\-msg [\-\-summary | \-\-no\-summray] \-F .SH "DESCRIPTION" Takes the list of merged objects on stdin and produces a suitable commit message to be used for the merge commit, usually to be passed as the \fI\fR argument of git\-merge. This script is intended mostly for internal use by scripts automatically invoking git\-merge. +.SH "OPTIONS" +.TP +\-\-summary +In addition to branch names, populate the log message with one\-line descriptions from the actual commits that are being merged. +.TP +\-\-no\-summary +Do not list one\-line descriptions from the actual commits being merged. +.TP +\-\-file , \-F +Take the list of merged objects from instead of stdin. +.SH "CONFIGURATION" +.TP +merge.summary +Whether to include summaries of merged commits in newly merge commit messages. False by default. .SH "SEE ALSO" \fBgit\-merge\fR(1) .SH "AUTHOR" diff --git a/man1/git-grep.1 b/man1/git-grep.1 index 0ccb40f52..3493d1eac 100644 --- a/man1/git-grep.1 +++ b/man1/git-grep.1 @@ -2,7 +2,7 @@ .\" 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\-GREP" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual" +.TH "GIT\-GREP" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -15,12 +15,13 @@ git\-grep \- Print lines matching a pattern \fIgit\-grep\fR [\-\-cached] [\-a | \-\-text] [\-I] [\-i | \-\-ignore\-case] [\-w | \-\-word\-regexp] [\-v | \-\-invert\-match] [\-h|\-H] [\-\-full\-name] - [\-E | \-\-extended\-regexp] [\-G | \-\-basic\-regexp] [\-F | \-\-fixed\-strings] - [\-n] [\-l | \-\-files\-with\-matches] [\-L | \-\-files\-without\-match] + [\-E | \-\-extended\-regexp] [\-G | \-\-basic\-regexp] + [\-F | \-\-fixed\-strings] [\-n] + [\-l | \-\-files\-with\-matches] [\-L | \-\-files\-without\-match] [\-c | \-\-count] [\-\-all\-match] [\-A ] [\-B ] [\-C ] - [\-f ] [\-e] [\-\-and|\-\-or|\-\-not|(|)|\-e \&...] - [\&...] + [\-f ] [\-e] + [\-\-and|\-\-or|\-\-not|(|)|\-e \&...] [\&...] [\-\-] [\&...] .fi .SH "DESCRIPTION" @@ -36,6 +37,9 @@ Process binary files as if they were text. \-i | \-\-ignore\-case Ignore case differences between the patterns and the files. .TP +\-I +Don't match the pattern in binary files. +.TP \-w | \-\-word\-regexp Match the pattern only at word boundary (either begin at the beginning of a line, or preceded by a non\-word character; end at the end of a line or followed by a non\-word character). .TP @@ -51,6 +55,9 @@ When run from a subdirectory, the command usually outputs paths relative to the \-E | \-\-extended\-regexp | \-G | \-\-basic\-regexp Use POSIX extended/basic regexp for patterns. Default is to use basic regexp. .TP +\-F | \-\-fixed\-strings +Use fixed strings for patterns (don't interpret pattern as a regex). +.TP \-n Prefix the line number to matching lines. .TP @@ -63,6 +70,9 @@ Instead of showing every matched line, show the number of lines that match. \-[ABC] Show context trailing (A \(em after), or leading (B \(em before), or both (C \(em context) lines, and place a line containing \-\- between contiguous groups of matches. .TP +\- +A shortcut for specifying \-C. +.TP \-f Read patterns from , one per line. .TP diff --git a/man1/git-http-fetch.1 b/man1/git-http-fetch.1 index 7c3044517..be79231fb 100644 --- a/man1/git-http-fetch.1 +++ b/man1/git-http-fetch.1 @@ -2,7 +2,7 @@ .\" 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\-HTTP\-FETCH" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual" +.TH "GIT\-HTTP\-FETCH" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -39,6 +39,9 @@ Instead of a commit id on the commandline (which is not expected in this case), .nf ['\\t'] .fi +.TP +\-\-recover +Verify that everything reachable from target is fetched. Used after an earlier fetch is interrupted. .SH "AUTHOR" Written by Linus Torvalds .SH "DOCUMENTATION" diff --git a/man1/git-http-push.1 b/man1/git-http-push.1 index 6a94a3bae..3d54b2e34 100644 --- a/man1/git-http-push.1 +++ b/man1/git-http-push.1 @@ -2,7 +2,7 @@ .\" 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\-HTTP\-PUSH" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual" +.TH "GIT\-HTTP\-PUSH" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -10,12 +10,12 @@ .SH "NAME" git\-http\-push \- Push objects over HTTP/DAV to another repository .SH "SYNOPSIS" -\fIgit\-http\-push\fR [\-\-complete] [\-\-force] [\-\-verbose] [\&...] +\fIgit\-http\-push\fR [\-\-all] [\-\-force] [\-\-verbose] [\&...] .SH "DESCRIPTION" Sends missing objects to remote repository, and updates the remote branch. .SH "OPTIONS" .TP -\-\-complete +\-\-all Do not assume that the remote repository is complete in its current state, and verify all objects in the entire local ref's history exist in the remote repository. .TP \-\-force @@ -24,6 +24,20 @@ Usually, the command refuses to update a remote ref that is not an ancestor of t \-\-verbose Report the list of objects being walked locally and the list of objects successfully sent to the remote repository. .TP +\-d, \-D +Remove from remote repository. The specified branch cannot be the remote HEAD. If \-d is specified the following other conditions must also be met: +.RS +.TP 3 +\(bu +Remote HEAD must resolve to an object that exists locally +.TP +\(bu +Specified branch resolves to an object that exists locally +.TP +\(bu +Specified branch is an ancestor of the remote HEAD +.RE +.TP \&... The remote refs to update. .SH "SPECIFYING THE REFS" diff --git a/man1/git-local-fetch.1 b/man1/git-local-fetch.1 index 72a4a98c0..1a6aff09c 100644 --- a/man1/git-local-fetch.1 +++ b/man1/git-local-fetch.1 @@ -2,7 +2,7 @@ .\" 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\-LOCAL\-FETCH" "1" "04/22/2007" "Git 1.5.1.2.241.gfdd3e" "Git Manual" +.TH "GIT\-LOCAL\-FETCH" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -27,6 +27,15 @@ Get all the objects. \-v Report what is downloaded. .TP +\-s +Instead of regular file\-to\-file copying use symbolic links to the objects in the remote repository. +.TP +\-l +Before attempting symlinks (if \-s is specified) or file\-to\-file copying the remote objects, try to hardlink the remote objects into the local repository. +.TP +\-n +Never attempt to file\-to\-file copy remote objects. Only useful with \-s or \-l command\-line options. +.TP \-w Writes the commit\-id into the filename under $GIT_DIR/refs/ on the local end after the transfer is complete. .TP @@ -36,6 +45,9 @@ Instead of a commit id on the commandline (which is not expected in this case), .nf ['\\t'] .fi +.TP +\-\-recover +Verify that everything reachable from target is fetched. Used after an earlier fetch is interrupted. .SH "AUTHOR" Written by Junio C Hamano .SH "DOCUMENTATION" diff --git a/man1/git-pull.1 b/man1/git-pull.1 index b7feae708..ddcbe8d78 100644 --- a/man1/git-pull.1 +++ b/man1/git-pull.1 @@ -2,7 +2,7 @@ .\" 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\-PULL" "1" "04/22/2007" "" "" +.TH "GIT\-PULL" "1" "04/27/2007" "Git 1.5.2.rc0.71.g4342" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -29,6 +29,12 @@ Produce the working tree and index state as if a real merge happened, but do not \-s , \-\-strategy= Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried. If there is no \-s option, a built\-in list of strategies is used instead (git\-merge\-recursive when merging a single head, git\-merge\-octopus otherwise). .TP +\-q, \-\-quiet +Pass \-\-quiet to git\-fetch\-pack and silence any other internally used programs. +.TP +\-v, \-\-verbose +Be verbose. +.TP \-a, \-\-append Append ref names and object names of fetched refs to the existing contents of .git/FETCH_HEAD. Without this option old data in .git/FETCH_HEAD will be overwritten. .TP @@ -38,7 +44,7 @@ When given, and the repository to fetch from is handled by \fIgit\-fetch\-pack\f \-f, \-\-force When git\-fetch is used with : refspec, it refuses to update the local branch unless the remote branch it fetches is a descendant of . This option overrides that check. .TP -\-\-no\-tags +\-n, \-\-no\-tags By default, git\-fetch fetches tags that point at objects that are downloaded from the remote repository and stores them locally. This option disables this automatic tag following. .TP \-t, \-\-tags -- 2.26.2