[gentoo-commits] proj/portage:master commit in: repoman/man/

[Zac Medico]

commit:     47a3f7e905b3ba252659fa1a98071d03a1560807
Author:     zlg <zlg <AT> gentoo <DOT> org>
AuthorDate: Thu Mar 29 22:31:22 2018 +0000
Commit:     Zac Medico <zmedico <AT> gentoo <DOT> org>
CommitDate: Fri Mar 30 02:31:44 2018 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=47a3f7e9

repoman man/repoman.1: Add "BEHAVIOR" section (fix bug 650520)

The manpage references "directory tree", but doesn't explicitly outline
the expected behavior when run anywhere above the package directory
level.

Exact name of section, location within the manpage, and/or wording open
to suggestions.

Bug: https://bugs.gentoo.org/650520
Requested-by: zlg <zlg <AT> gentoo.org>
Signed-off-by: zlg <zlg <AT> gentoo.org>

 repoman/man/repoman.1 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/repoman/man/repoman.1 b/repoman/man/repoman.1
index db6526b5e..6a591e59d 100644
--- a/repoman/man/repoman.1
+++ b/repoman/man/repoman.1
@@ -1,4 +1,4 @@
-.TH "REPOMAN" "1" "Jun 2017" "Repoman VERSION" "Repoman"
+.TH "REPOMAN" "1" "Mar 2018" "Repoman VERSION" "Repoman"
 .SH NAME
 repoman \- Gentoo's program to enforce a minimal level of quality assurance in
 packages added to the portage tree
@@ -437,6 +437,12 @@ not directly.
 .B wxwidgets.eclassnotused
 Ebuild DEPENDs on x11-libs/wxGTK without inheriting wxwidgets.eclass. Refer to
 bug #305469 for more information.
+.SH "BEHAVIOR"
+When invoked from a level higher than a package directory, \fBrepoman\fR
+will recurse through a directory tree and execute the given command
+on a per\-package basis, e.g. \fBrepoman manifest\fR at the root of
+the repository will generate manifests for every package within the
+repository.
 .SH "REPORTING BUGS"
 Please report bugs via https://bugs.gentoo.org/
 .SH AUTHORS