diff options
Diffstat (limited to 'man1/git-fetch.1')
-rw-r--r-- | man1/git-fetch.1 | 32 |
1 files changed, 29 insertions, 3 deletions
diff --git a/man1/git-fetch.1 b/man1/git-fetch.1 index af5eb6dd7..8226f9481 100644 --- a/man1/git-fetch.1 +++ b/man1/git-fetch.1 @@ -2,12 +2,12 @@ .\" Title: git-fetch .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2023-05-11 +.\" Date: 2023-05-15 .\" Manual: Git Manual -.\" Source: Git 2.40.1.556.g5bc069e383 +.\" Source: Git 2.41.0.rc0 .\" Language: English .\" -.TH "GIT\-FETCH" "1" "2023\-05\-11" "Git 2\&.40\&.1\&.556\&.g5bc069" "Git Manual" +.TH "GIT\-FETCH" "1" "2023\-05\-15" "Git 2\&.41\&.0\&.rc0" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -146,6 +146,19 @@ option, see Show what would be done, without making any changes\&. .RE .PP +\-\-porcelain +.RS 4 +Print the output to standard output in an easy\-to\-parse format for scripts\&. See section OUTPUT in +\fBgit-fetch\fR(1) +for details\&. +.sp +This is incompatible with +\fB\-\-recurse\-submodules=[yes|on\-demand]\fR +and takes precedence over the +\fBfetch\&.output\fR +config option\&. +.RE +.PP \-\-[no\-]write\-fetch\-head .RS 4 Write the list of remote refs fetched in the @@ -998,6 +1011,19 @@ The status of the fetch is output in tabular form, with each line representing t .\} .sp .sp +When using \fB\-\-porcelain\fR, the output format is intended to be machine\-parseable\&. In contrast to the human\-readable output formats it thus prints to standard output instead of standard error\&. Each line is of the form: +.sp +.if n \{\ +.RS 4 +.\} +.nf +<flag> <old\-object\-id> <new\-object\-id> <local\-reference> +.fi +.if n \{\ +.RE +.\} +.sp +.sp The status of up\-to\-date refs is shown only if the \-\-verbose option is used\&. .sp In compact output mode, specified with configuration variable fetch\&.output, if either entire \fB<from>\fR or \fB<to>\fR is found in the other string, it will be substituted with \fB*\fR in the other string\&. For example, \fBmaster \-> origin/master\fR becomes \fBmaster \-> origin/*\fR\&. |