Red Hat Bugzilla – Bug 166119
Yum shell undocumented in man pages
Last modified: 2014-01-21 17:52:30 EST
Description of problem:
Yum provides a shell, which is not documented in the manpage or info page.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. check manpage and search for /shell/. The only references are to
file-globbing. No reference to a built-in shell and additional yum commands
Scripts such as yum.cron are confusing if you don't know that yum provides a
shell. And the commands in yum-daily.yum are foreign unless you know that yum
has a shell with additional commands, such as 'ts run' that are not in the man page.
If yum can do it, it should be documented. There appears to be some help text
for the yum shell, but it is available only by invoking the shell and using the
help command, which is not the same as the --help option (this is documented).
Currently, the only way to discover this is either to experiment or to locate
release notes or mailing list postings on this topic.
At the very least, the manpage should mention that the command
will invoke an internal shell. The manpage should at least indicate that more
help is available if you try the 'shell' command and type 'help'.
Yum is actually a third-party product, although the developers are closely
involved with Fedora. The best place to file bugs on the supplied man pages is
directly on the yum project Bugzilla:
I've now opened a new bug for updating the Fedora documentation to include this
information, so that we can give people better advice on where to file bugs:
I've reopened this bug for the developers so that the reporter doesn't have to
file a new one.
Closing - this is fixed in yum 2.4.0 which was released on this last saturday.
Thanks Paul for saving me some trouble, and Seth for the update. Erik