repoman's documentation doesn't clearly indicate that it can be used to recurse into directories. Users and some developers may incorrectly assume that repoman is only used in individual package directories, and give themselves more work by trying to solve the directory recursion problem on their own.
An explicit note that repoman recurses through directories avoids this confusion and communicates the true value of repoman as a repository-wide tool.
Steps to Reproduce:
1. man repoman
2. search for 'recurs' or 'example' or any other meaningful word associated with directory traversal.
Nothing meaningful found to communicate what repoman does when invoked at a level higher than a package directory.
Some indication (or an example) showing that repoman can do things at the repository level, especially with modes that are at the package level, e.g. 'repoman manifest' at the root of a repository can and will generate manifests for all packages. Documentation should outline this behavior.
Created attachment 526138 [details, diff]
Proposed patch; also sent to gentoo-portage-dev ML for comments.
The bug has been referenced in the following commit(s):
Author: zlg <email@example.com>
AuthorDate: 2018-03-29 22:31:22 +0000
Commit: Zac Medico <firstname.lastname@example.org>
CommitDate: 2018-03-30 02:31:44 +0000
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
Exact name of section, location within the manpage, and/or wording open
Requested-by: zlg <email@example.com>
Signed-off-by: zlg <firstname.lastname@example.org>
repoman/man/repoman.1 | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)}
Fixed in repoman-2.3.8.