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-diffmanifests.1 | 61 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 man/repo-diffmanifests.1 (limited to 'man/repo-diffmanifests.1') diff --git a/man/repo-diffmanifests.1 b/man/repo-diffmanifests.1 new file mode 100644 index 00000000..add50f17 --- /dev/null +++ b/man/repo-diffmanifests.1 @@ -0,0 +1,61 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man. +.TH REPO "1" "July 2021" "repo diffmanifests" "Repo Manual" +.SH NAME +repo \- repo diffmanifests - manual page for repo diffmanifests +.SH SYNOPSIS +.B repo +\fI\,diffmanifests manifest1.xml \/\fR[\fI\,manifest2.xml\/\fR] [\fI\,options\/\fR] +.SH DESCRIPTION +Summary +.PP +Manifest diff utility +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-\-raw\fR +display raw diff +.TP +\fB\-\-no\-color\fR +does not display the diff in color +.TP +\fB\-\-pretty\-format=\fR +print the log using a custom git pretty format string +.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 diffmanifests` to view the detailed manual. +.SH DETAILS +.PP +The repo diffmanifests command shows differences between project revisions of +manifest1 and manifest2. if manifest2 is not specified, current manifest.xml +will be used instead. Both absolute and relative paths may be used for +manifests. Relative paths start from project's ".repo/manifests" folder. +.PP +The \fB\-\-raw\fR option Displays the diff in a way that facilitates parsing, the +project pattern will be [] and the +commit pattern will be with status values respectively : +.IP +A = Added project +R = Removed project +C = Changed project +U = Project with unreachable revision(s) (revision(s) not found) +.PP +for project, and +.IP +A = Added commit +R = Removed commit +.PP +for a commit. +.PP +Only changed projects may contain commits, and commit status always starts with +a space, and are part of last printed project. Unreachable revisions may occur +if project is not up to date or if repo has not been initialized with all the +groups, in which case some projects won't be synced and their revisions won't be +found. -- cgit v1.2.3-54-g00ecf