From e6601067ed5d2848f0610d6dd012e7707281a215 Mon Sep 17 00:00:00 2001 From: Mike Frysinger Date: Fri, 12 Nov 2021 01:41:29 -0500 Subject: [PATCH] man: refresh pages Change-Id: I3f2c3ad77c16a76276bba2954887ab9e7605661c Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/323516 Reviewed-by: Jack Neus Tested-by: Mike Frysinger --- man/repo-gitc-init.1 | 13 +++++++------ man/repo-init.1 | 13 +++++++------ man/repo-manifest.1 | 17 ++++++++++++++--- man/repo-smartsync.1 | 11 ++++++++--- man/repo-sync.1 | 11 ++++++++--- 5 files changed, 44 insertions(+), 21 deletions(-) diff --git a/man/repo-gitc-init.1 b/man/repo-gitc-init.1 index 9b61866e..63be877f 100644 --- a/man/repo-gitc-init.1 +++ b/man/repo-gitc-init.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "September 2021" "repo gitc-init" "Repo Manual" +.TH REPO "1" "November 2021" "repo gitc-init" "Repo Manual" .SH NAME repo \- repo gitc-init - manual page for repo gitc-init .SH SYNOPSIS @@ -31,10 +31,6 @@ manifest branch or revision (use HEAD for default) \fB\-m\fR NAME.xml, \fB\-\-manifest\-name\fR=\fI\,NAME\/\fR.xml initial manifest file .TP -\fB\-\-standalone\-manifest\fR -download the manifest as a static file rather then -create a git checkout of the manifest repo -.TP \fB\-g\fR GROUP, \fB\-\-groups\fR=\fI\,GROUP\/\fR restrict manifest projects to ones with specified group(s) [default|all|G1,G2,G3|G4,\-G5,\-G6] @@ -45,6 +41,10 @@ platform group [auto|all|none|linux|darwin|...] .TP \fB\-\-submodules\fR sync any submodules associated with the manifest repo +.TP +\fB\-\-standalone\-manifest\fR +download the manifest as a static file rather then +create a git checkout of the manifest repo .SS Manifest (only) checkout options: .TP \fB\-\-current\-branch\fR @@ -96,7 +96,8 @@ filter for use with \fB\-\-partial\-clone\fR [default: blob:none] .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects +use the manifest superproject to sync projects; +implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects diff --git a/man/repo-init.1 b/man/repo-init.1 index 9957b64d..6faaab0b 100644 --- a/man/repo-init.1 +++ b/man/repo-init.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "September 2021" "repo init" "Repo Manual" +.TH REPO "1" "November 2021" "repo init" "Repo Manual" .SH NAME repo \- repo init - manual page for repo init .SH SYNOPSIS @@ -31,10 +31,6 @@ manifest branch or revision (use HEAD for default) \fB\-m\fR NAME.xml, \fB\-\-manifest\-name\fR=\fI\,NAME\/\fR.xml initial manifest file .TP -\fB\-\-standalone\-manifest\fR -download the manifest as a static file rather then -create a git checkout of the manifest repo -.TP \fB\-g\fR GROUP, \fB\-\-groups\fR=\fI\,GROUP\/\fR restrict manifest projects to ones with specified group(s) [default|all|G1,G2,G3|G4,\-G5,\-G6] @@ -45,6 +41,10 @@ platform group [auto|all|none|linux|darwin|...] .TP \fB\-\-submodules\fR sync any submodules associated with the manifest repo +.TP +\fB\-\-standalone\-manifest\fR +download the manifest as a static file rather then +create a git checkout of the manifest repo .SS Manifest (only) checkout options: .TP \fB\-c\fR, \fB\-\-current\-branch\fR @@ -96,7 +96,8 @@ filter for use with \fB\-\-partial\-clone\fR [default: blob:none] .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects +use the manifest superproject to sync projects; +implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects diff --git a/man/repo-manifest.1 b/man/repo-manifest.1 index be467607..ab9f7ed3 100644 --- a/man/repo-manifest.1 +++ b/man/repo-manifest.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2021" "repo manifest" "Repo Manual" +.TH REPO "1" "November 2021" "repo manifest" "Repo Manual" .SH NAME repo \- repo manifest - manual page for repo manifest .SH SYNOPSIS @@ -161,6 +161,7 @@ CDATA #IMPLIED> + @@ -174,8 +175,9 @@ CDATA #IMPLIED> .IP - - + + + .IP @@ -385,6 +387,11 @@ original manifest. Attribute `path`: If specified, limit the change to projects checked out at the specified path, rather than all projects with the given name. .PP +Attribute `dest\-path`: If specified, a path relative to the top directory of the +repo client where the Git working directory for this project should be placed. +This is used to move a project in the checkout by overriding the existing `path` +setting. +.PP Attribute `groups`: List of additional groups to which this project belongs. Same syntax as the corresponding element of `project`. .PP @@ -477,6 +484,10 @@ project](#element\-project) for more information. Attribute `remote`: Name of a previously defined remote element. If not supplied the remote given by the default element is used. .PP +Attribute `revision`: Name of the Git branch the manifest wants to track for +this superproject. If not supplied the revision given by the remote element is +used if applicable, else the default element is used. +.PP Element contactinfo .PP *** *Note*: This is currently a WIP. *** diff --git a/man/repo-smartsync.1 b/man/repo-smartsync.1 index 5d939117..718ef190 100644 --- a/man/repo-smartsync.1 +++ b/man/repo-smartsync.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2021" "repo smartsync" "Repo Manual" +.TH REPO "1" "November 2021" "repo smartsync" "Repo Manual" .SH NAME repo \- repo smartsync - manual page for repo smartsync .SH SYNOPSIS @@ -80,7 +80,8 @@ password to authenticate with the manifest server fetch submodules from server .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects +use the manifest superproject to sync projects; +implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects @@ -89,7 +90,7 @@ disable use of manifest superprojects fetch tags .TP \fB\-\-no\-tags\fR -don't fetch tags +don't fetch tags (default) .TP \fB\-\-optimized\-fetch\fR only fetch projects fixed to sha1 if revision does not @@ -100,6 +101,10 @@ number of times to retry fetches on transient errors .TP \fB\-\-prune\fR delete refs that no longer exist on the remote +(default) +.TP +\fB\-\-no\-prune\fR +do not delete refs that no longer exist on the remote .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR diff --git a/man/repo-sync.1 b/man/repo-sync.1 index c87c9701..63f41409 100644 --- a/man/repo-sync.1 +++ b/man/repo-sync.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2021" "repo sync" "Repo Manual" +.TH REPO "1" "November 2021" "repo sync" "Repo Manual" .SH NAME repo \- repo sync - manual page for repo sync .SH SYNOPSIS @@ -80,7 +80,8 @@ password to authenticate with the manifest server fetch submodules from server .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects +use the manifest superproject to sync projects; +implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects @@ -89,7 +90,7 @@ disable use of manifest superprojects fetch tags .TP \fB\-\-no\-tags\fR -don't fetch tags +don't fetch tags (default) .TP \fB\-\-optimized\-fetch\fR only fetch projects fixed to sha1 if revision does not @@ -100,6 +101,10 @@ number of times to retry fetches on transient errors .TP \fB\-\-prune\fR delete refs that no longer exist on the remote +(default) +.TP +\fB\-\-no\-prune\fR +do not delete refs that no longer exist on the remote .TP \fB\-s\fR, \fB\-\-smart\-sync\fR smart sync using manifest from the latest known good