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-rebase.1 | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 man/repo-rebase.1 (limited to 'man/repo-rebase.1') diff --git a/man/repo-rebase.1 b/man/repo-rebase.1 new file mode 100644 index 00000000..aa261036 --- /dev/null +++ b/man/repo-rebase.1 @@ -0,0 +1,55 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man. +.TH REPO "1" "July 2021" "repo rebase" "Repo Manual" +.SH NAME +repo \- repo rebase - manual page for repo rebase +.SH SYNOPSIS +.B repo +\fI\,rebase {\/\fR[\fI\,\/\fR...] \fI\,| -i \/\fR...\fI\,}\/\fR +.SH DESCRIPTION +Summary +.PP +Rebase local branches on upstream branch +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-\-fail\-fast\fR +stop rebasing after first error is hit +.TP +\fB\-f\fR, \fB\-\-force\-rebase\fR +pass \fB\-\-force\-rebase\fR to git rebase +.TP +\fB\-\-no\-ff\fR +pass \fB\-\-no\-ff\fR to git rebase +.TP +\fB\-\-autosquash\fR +pass \fB\-\-autosquash\fR to git rebase +.TP +\fB\-\-whitespace\fR=\fI\,WS\/\fR +pass \fB\-\-whitespace\fR to git rebase +.TP +\fB\-\-auto\-stash\fR +stash local modifications before starting +.TP +\fB\-m\fR, \fB\-\-onto\-manifest\fR +rebase onto the manifest version instead of upstream +HEAD (this helps to make sure the local tree stays +consistent if you previously synced to a manifest) +.SS Logging options: +.TP +\fB\-v\fR, \fB\-\-verbose\fR +show all output +.TP +\fB\-q\fR, \fB\-\-quiet\fR +only show errors +.TP +\fB\-i\fR, \fB\-\-interactive\fR +interactive rebase (single project only) +.PP +Run `repo help rebase` to view the detailed manual. +.SH DETAILS +.PP +\&'repo rebase' uses git rebase to move local changes in the current topic branch +to the HEAD of the upstream history, useful when you have made commits in a +topic branch but need to incorporate new upstream changes "underneath" them. -- cgit v1.2.3-54-g00ecf