summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2017-09-02 21:08:45 +0200
committerMichał Górny <mgorny@gentoo.org>2017-09-11 22:32:45 +0200
commitee39ad638e341de937fc1e5ccf5dc653f641b4e9 (patch)
tree29db729cf5a7471b0b2f659c82016b91936d1dd4
parentrepoman: Unify usage of --bug and --closes options (diff)
downloadportage-ee39ad638e341de937fc1e5ccf5dc653f641b4e9.tar.gz
portage-ee39ad638e341de937fc1e5ccf5dc653f641b4e9.tar.bz2
portage-ee39ad638e341de937fc1e5ccf5dc653f641b4e9.zip
repoman: Update --bug/--closes description for bugs.g.o hooks
Update the description for --bug and --closes to account for the fact that the tags are now handled by git hooks on Gentoo Infra, and cause actions on Gentoo Bugzilla. Closes: https://github.com/gentoo/portage/pull/203 Reviewed-by: Zac Medico <zmedico@gentoo.org>
-rw-r--r--repoman/man/repoman.113
1 files changed, 11 insertions, 2 deletions
diff --git a/repoman/man/repoman.1 b/repoman/man/repoman.1
index 41df8ed2f..813bdae21 100644
--- a/repoman/man/repoman.1
+++ b/repoman/man/repoman.1
@@ -27,14 +27,23 @@ be either a Gentoo bug number or a full bug URL (either Gentoo
or upstream). Gentoo bug URLs are automatically shortened to
the canonical \fBhttps://bugs.gentoo.org/NNNNNN\fR form, and HTTPS
is forced for known bug trackers.
+
+When pushing to the Gentoo repository, the reference to the commit
+will be automatically added as a comment on the bug.
.TP
\fB-c\fR, \fB--closes\fR
Include a \fBCloses\fR tag in the commit message footer that can be used
-to close pull requests (and issues) on GitHub and other compatible
-services (GitLab, Bitbucket). The argument can be either a Gentoo bug
+to close bugs and pull requests. The argument can be either a Gentoo bug
number or a full PR/bug URL. Gentoo bug URLs are automatically shortened
to the canonical \fBhttps://bugs.gentoo.org/NNNNNN\fR form, and HTTPS
is forced for known bug trackers.
+
+When pushing to the Gentoo repository, the referenced bugs will be
+closed as RESOLVED/FIXED automatically with a comment referencing
+the commit. Furthermore, GitHub pull requests will be closed as well
+due to the automatic GitHub mirroring.
+
+Other platforms using the \fBCloses\fR tag include GitLab and Bitbucket.
.TP
\fB\-\-digest=<y|n>\fR
Automatically update Manifest digests for modified files. This