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): 2.3.2-7 How reproducible: N/A. 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 available there. 2. 3. Actual results: 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. Expected results: 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). Additional info: 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 yum shell 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: https://devel.linux.duke.edu/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: https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=166122
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