mirror of
https://gerrit.googlesource.com/git-repo
synced 2024-12-21 07:16:21 +00:00
0a1f533e28
Debian package started to ship manpages for repo since 2.8 [1] And it's about for one year. So I think it should be upstreamed. The script depends on help2man, which is available in both debian [2] and ubuntu [3]. [1] https://tracker.debian.org/news/1150858/accepted-repo-28-1-source-into-unstable [2] https://tracker.debian.org/pkg/help2man [3] https://launchpad.net/ubuntu/+source/help2man Change-Id: Ide2b356d0944ebde34cc96c6d5a782655bd72288 Signed-off-by: Roger Shimizu <rosh@debian.org> Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/309782 Reviewed-by: Mike Frysinger <vapier@google.com>
175 lines
5.5 KiB
Groff
175 lines
5.5 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
|
|
.TH REPO "1" "July 2021" "repo upload" "Repo Manual"
|
|
.SH NAME
|
|
repo \- repo upload - manual page for repo upload
|
|
.SH SYNOPSIS
|
|
.B repo
|
|
\fI\,upload \/\fR[\fI\,--re --cc\/\fR] [\fI\,<project>\/\fR]...
|
|
.SH DESCRIPTION
|
|
Summary
|
|
.PP
|
|
Upload changes for code review
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
show this help message and exit
|
|
.TP
|
|
\fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR
|
|
number of jobs to run in parallel (default: 4)
|
|
.TP
|
|
\fB\-t\fR
|
|
send local branch name to Gerrit Code Review
|
|
.TP
|
|
\fB\-\-hashtag\fR=\fI\,HASHTAGS\/\fR, \fB\-\-ht\fR=\fI\,HASHTAGS\/\fR
|
|
add hashtags (comma delimited) to the review
|
|
.TP
|
|
\fB\-\-hashtag\-branch\fR, \fB\-\-htb\fR
|
|
add local branch name as a hashtag
|
|
.TP
|
|
\fB\-l\fR LABELS, \fB\-\-label\fR=\fI\,LABELS\/\fR
|
|
add a label when uploading
|
|
.TP
|
|
\fB\-\-re\fR=\fI\,REVIEWERS\/\fR, \fB\-\-reviewers\fR=\fI\,REVIEWERS\/\fR
|
|
request reviews from these people
|
|
.TP
|
|
\fB\-\-cc\fR=\fI\,CC\/\fR
|
|
also send email to these email addresses
|
|
.TP
|
|
\fB\-\-br\fR=\fI\,BRANCH\/\fR, \fB\-\-branch\fR=\fI\,BRANCH\/\fR
|
|
(local) branch to upload
|
|
.TP
|
|
\fB\-c\fR, \fB\-\-current\-branch\fR
|
|
upload current git branch
|
|
.TP
|
|
\fB\-\-no\-current\-branch\fR
|
|
upload all git branches
|
|
.TP
|
|
\fB\-\-ne\fR, \fB\-\-no\-emails\fR
|
|
do not send e\-mails on upload
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-private\fR
|
|
upload as a private change (deprecated; use \fB\-\-wip\fR)
|
|
.TP
|
|
\fB\-w\fR, \fB\-\-wip\fR
|
|
upload as a work\-in\-progress change
|
|
.TP
|
|
\fB\-o\fR PUSH_OPTIONS, \fB\-\-push\-option\fR=\fI\,PUSH_OPTIONS\/\fR
|
|
additional push options to transmit
|
|
.TP
|
|
\fB\-D\fR BRANCH, \fB\-\-destination\fR=\fI\,BRANCH\/\fR, \fB\-\-dest\fR=\fI\,BRANCH\/\fR
|
|
submit for review on this target branch
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-dry\-run\fR
|
|
do everything except actually upload the CL
|
|
.TP
|
|
\fB\-y\fR, \fB\-\-yes\fR
|
|
answer yes to all safe prompts
|
|
.TP
|
|
\fB\-\-no\-cert\-checks\fR
|
|
disable verifying ssl certs (unsafe)
|
|
.SS Logging options:
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
show all output
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
only show errors
|
|
.SS pre\-upload hooks:
|
|
.TP
|
|
\fB\-\-no\-verify\fR
|
|
Do not run the pre\-upload hook.
|
|
.TP
|
|
\fB\-\-verify\fR
|
|
Run the pre\-upload hook without prompting.
|
|
.TP
|
|
\fB\-\-ignore\-hooks\fR
|
|
Do not abort if pre\-upload hooks fail.
|
|
.PP
|
|
Run `repo help upload` to view the detailed manual.
|
|
.SH DETAILS
|
|
.PP
|
|
The 'repo upload' command is used to send changes to the Gerrit Code Review
|
|
system. It searches for topic branches in local projects that have not yet been
|
|
published for review. If multiple topic branches are found, 'repo upload' opens
|
|
an editor to allow the user to select which branches to upload.
|
|
.PP
|
|
\&'repo upload' searches for uploadable changes in all projects listed at the
|
|
command line. Projects can be specified either by name, or by a relative or
|
|
absolute path to the project's local directory. If no projects are specified,
|
|
\&'repo upload' will search for uploadable changes in all projects listed in the
|
|
manifest.
|
|
.PP
|
|
If the \fB\-\-reviewers\fR or \fB\-\-cc\fR options are passed, those emails are added to the
|
|
respective list of users, and emails are sent to any new users. Users passed as
|
|
\fB\-\-reviewers\fR must already be registered with the code review system, or the
|
|
upload will fail.
|
|
.PP
|
|
Configuration
|
|
.PP
|
|
review.URL.autoupload:
|
|
.PP
|
|
To disable the "Upload ... (y/N)?" prompt, you can set a per\-project or global
|
|
Git configuration option. If review.URL.autoupload is set to "true" then repo
|
|
will assume you always answer "y" at the prompt, and will not prompt you
|
|
further. If it is set to "false" then repo will assume you always answer "n",
|
|
and will abort.
|
|
.PP
|
|
review.URL.autoreviewer:
|
|
.PP
|
|
To automatically append a user or mailing list to reviews, you can set a
|
|
per\-project or global Git option to do so.
|
|
.PP
|
|
review.URL.autocopy:
|
|
.PP
|
|
To automatically copy a user or mailing list to all uploaded reviews, you can
|
|
set a per\-project or global Git option to do so. Specifically,
|
|
review.URL.autocopy can be set to a comma separated list of reviewers who you
|
|
always want copied on all uploads with a non\-empty \fB\-\-re\fR argument.
|
|
.PP
|
|
review.URL.username:
|
|
.PP
|
|
Override the username used to connect to Gerrit Code Review. By default the
|
|
local part of the email address is used.
|
|
.PP
|
|
The URL must match the review URL listed in the manifest XML file, or in the
|
|
\&.git/config within the project. For example:
|
|
.IP
|
|
[remote "origin"]
|
|
.IP
|
|
url = git://git.example.com/project.git
|
|
review = http://review.example.com/
|
|
.IP
|
|
[review "http://review.example.com/"]
|
|
.IP
|
|
autoupload = true
|
|
autocopy = johndoe@company.com,my\-team\-alias@company.com
|
|
.PP
|
|
review.URL.uploadtopic:
|
|
.PP
|
|
To add a topic branch whenever uploading a commit, you can set a per\-project or
|
|
global Git option to do so. If review.URL.uploadtopic is set to "true" then repo
|
|
will assume you always want the equivalent of the \fB\-t\fR option to the repo command.
|
|
If unset or set to "false" then repo will make use of only the command line
|
|
option.
|
|
.PP
|
|
review.URL.uploadhashtags:
|
|
.PP
|
|
To add hashtags whenever uploading a commit, you can set a per\-project or global
|
|
Git option to do so. The value of review.URL.uploadhashtags will be used as
|
|
comma delimited hashtags like the \fB\-\-hashtag\fR option.
|
|
.PP
|
|
review.URL.uploadlabels:
|
|
.PP
|
|
To add labels whenever uploading a commit, you can set a per\-project or global
|
|
Git option to do so. The value of review.URL.uploadlabels will be used as comma
|
|
delimited labels like the \fB\-\-label\fR option.
|
|
.PP
|
|
review.URL.uploadnotify:
|
|
.PP
|
|
Control e\-mail notifications when uploading.
|
|
https://gerrit\-review.googlesource.com/Documentation/user\-upload.html#notify
|
|
.PP
|
|
References
|
|
.PP
|
|
Gerrit Code Review: https://www.gerritcodereview.com/
|