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-list.1 | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 man/repo-list.1 (limited to 'man/repo-list.1') diff --git a/man/repo-list.1 b/man/repo-list.1 new file mode 100644 index 00000000..a86315ae --- /dev/null +++ b/man/repo-list.1 @@ -0,0 +1,57 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man. +.TH REPO "1" "July 2021" "repo list" "Repo Manual" +.SH NAME +repo \- repo list - manual page for repo list +.SH SYNOPSIS +.B repo +\fI\,list \/\fR[\fI\,-f\/\fR] [\fI\,\/\fR...] +.SH DESCRIPTION +Summary +.PP +List projects and their associated directories +.PP +repo list [\-f] \fB\-r\fR str1 [str2]... +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-r\fR, \fB\-\-regex\fR +filter the project list based on regex or wildcard +matching of strings +.TP +\fB\-g\fR GROUPS, \fB\-\-groups\fR=\fI\,GROUPS\/\fR +filter the project list based on the groups the +project is in +.TP +\fB\-a\fR, \fB\-\-all\fR +show projects regardless of checkout state +.TP +\fB\-f\fR, \fB\-\-fullpath\fR +display the full work tree path instead of the +relative path +.TP +\fB\-n\fR, \fB\-\-name\-only\fR +display only the name of the repository +.TP +\fB\-p\fR, \fB\-\-path\-only\fR +display only the path of the repository +.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 list` to view the detailed manual. +.SH DETAILS +.PP +List all projects; pass '.' to list the project for the cwd. +.PP +By default, only projects that currently exist in the checkout are shown. If you +want to list all projects (using the specified filter settings), use the \fB\-\-all\fR +option. If you want to show all projects regardless of the manifest groups, then +also pass \fB\-\-groups\fR all. +.PP +This is similar to running: repo forall \fB\-c\fR 'echo "$REPO_PATH : $REPO_PROJECT"'. -- cgit v1.2.3-54-g00ecf