The RPM manpages don't mention the additional functionality enabled by the
[burt@bar ~]$ rpm -q rpm
[burt@bar ~]$ rpm -q rpmdb-redhat
[burt@bar ~]$ rpm --help | grep redhatprovides
--redhatprovides find package name that contains a provided
[burt@bar ~]$ man rpm | grep redhatprovides
I choose not to document popt aliases like
--redhatprovides in the man page, as the
alias is configurable window dressing for
a slightly more complicated option. The other
reason for not documenting is that --redhatprovides
is a pretty feeble hack, but that's a different matter.
Yes this is somewhat confusing.
Both of these strike me as pretty poor reasons to exclude documentation.
The end user doesn't care (or even know) about popt aliases, nor do they care
that it indeed 'feeble'.
IMHO, you should either document it in the man page or remove it altogether.
OK, --redhatprovides et al is targeted for removal.