From 0a1f533e2835c856473e3e4046341a4d2f66764b Mon Sep 17 00:00:00 2001 From: Roger Shimizu Date: Sun, 20 Jun 2021 21:41:05 +0900 Subject: Add script 'release/update-manpages' to generate manpages 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 Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/309782 Reviewed-by: Mike Frysinger --- man/repo-branches.1 | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 man/repo-branches.1 (limited to 'man/repo-branches.1') diff --git a/man/repo-branches.1 b/man/repo-branches.1 new file mode 100644 index 00000000..0080e467 --- /dev/null +++ b/man/repo-branches.1 @@ -0,0 +1,58 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man. +.TH REPO "1" "July 2021" "repo branches" "Repo Manual" +.SH NAME +repo \- repo branches - manual page for repo branches +.SH SYNOPSIS +.B repo +\fI\,branches \/\fR[\fI\,\/\fR...] +.SH DESCRIPTION +Summary +.PP +View current topic branches +.PP +Summarizes the currently available topic branches. +.PP +# Branch Display +.PP +The branch display output by this command is organized into four +columns of information; for example: +.TP +*P nocolor +| in repo +.TP +repo2 +| +.PP +The first column contains a * if the branch is the currently +checked out branch in any of the specified projects, or a blank +if no project has the branch checked out. +.PP +The second column contains either blank, p or P, depending upon +the upload status of the branch. +.IP +(blank): branch not yet published by repo upload +.IP +P: all commits were published by repo upload +p: only some commits were published by repo upload +.PP +The third column contains the branch name. +.PP +The fourth column (after the | separator) lists the projects that +the branch appears in, or does not appear in. If no project list +is shown, then the branch appears in all projects. +.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) +.SS Logging options: +.TP +\fB\-v\fR, \fB\-\-verbose\fR +show all output +.TP +\fB\-q\fR, \fB\-\-quiet\fR +only show errors +.PP +Run `repo help branches` to view the detailed manual. -- cgit v1.2.3-54-g00ecf