Bug 865694
| Summary: | yum-security man page has errors | ||||||
|---|---|---|---|---|---|---|---|
| Product: | Red Hat Enterprise Linux 6 | Reporter: | Karel Srot <ksrot> | ||||
| Component: | yum-utils | Assignee: | Valentina Mukhamedzhanova <vmukhame> | ||||
| Status: | CLOSED ERRATA | QA Contact: | Eva Mrakova <emrakova> | ||||
| Severity: | low | Docs Contact: | |||||
| Priority: | low | ||||||
| Version: | 6.3 | CC: | calestyo, emrakova, james.antill, jchaloup, ksrot, pschiffe, tcallawa, vmukhame | ||||
| Target Milestone: | rc | Keywords: | ManPageChange | ||||
| Target Release: | --- | ||||||
| Hardware: | Unspecified | ||||||
| OS: | Unspecified | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | yum-utils-1.1.30-33.el6 | Doc Type: | Bug Fix | ||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | Environment: | ||||||
| Last Closed: | 2016-05-10 21:31:02 UTC | Type: | Bug | ||||
| Regression: | --- | Mount Type: | --- | ||||
| Documentation: | --- | CRM: | |||||
| Verified Versions: | Category: | --- | |||||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
| Cloudforms Team: | --- | Target Upstream Version: | |||||
| Embargoed: | |||||||
| Attachments: |
|
||||||
This request was evaluated by Red Hat Product Management for inclusion in the current release of Red Hat Enterprise Linux. Because the affected component is not scheduled to be updated in the current release, Red Hat is unable to address this request at this time. Red Hat invites you to ask your support representative to propose this request, if appropriate, in the next release of Red Hat Enterprise Linux. Created attachment 909871 [details] yum-security.8 update plus display enhancement > * Description for the "summary" command is missing $ yum --security summary Loaded plugins: product-id, refresh-packagekit, security, subscription-manager No such command: summary. Please use /usr/bin/yum --help $ /usr/bin/yum --help | grep summary | wc -l 0 - list removed - yum updateinfo added - some rearranging and display enhancement of lines Added yum commands are:
yum update-minimal
This works like the update command, but if you have the the package foo-1 installed and have foo-2 and foo-3 available with updateinfo.xml then update-
minimal will update you to foo-3.
yum updateinfo info <sub-command>
yum updateinfo list <sub-command>
yum updateinfo summary <sub-command>
yum updateinfo <sub-command>
Defaults to yum updateinfo summary
where <sub-command> is:
yum updateinfo * all
yum updateinfo * available
yum updateinfo * installed
yum updateinfo * updates
yum --security summary is missing, was it removed? The rest of the changes, is it ok fo you? (In reply to Jan Chaloupka from comment #5) > yum --security summary is missing, was it removed? The rest of the changes, > is it ok fo you? This is documented in man yum-security which is provided by yum-plugin-security. Hi Jan, I am sorry, I misunderstood your comment.
What I mean by
> * Description for the "summary" command is missing
is that the "summary" is not documented in the Description section, beside "info" and "list" and other commands/options. It is only mentioned in "yum updateinfo summary" without further explanation and in examples.
$ yum --security summary
This is of course wrong. Must be run as "yum updateinfo summary".
Karel, I should have been more verbose. Thank you for explanation.
Using the grep output, summary could be commented as:
summary
Is used to get a summary of advisories not yet installed.
James, what do you think?
Hi Jan, summary is not specific for installed advisories. Commands info/list/summary can be provided with subcommands all/available/installed/updates. Therefore I would propose to make the "summary" description similar to the current description of "info" and "list" commands. E.g. summary Is used to show the summary of errata notice information, from the updateinfo.xml data in yum. This includes bugzillas, CVEs, security updates and new. Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. https://rhn.redhat.com/errata/RHEA-2016-0837.html |
Description of problem: There are some errors in yum-security man page. * Description for "list" command is listed twice * Description for the "summary" command is missing * 3 possible use cases for updateinfo are listed yum updateinfo info yum updateinfo list yum updateinfo summary It should be mentioned that "yum updateinfo" is working too, i.e. that the "summary" is the default. * There should be one blank before "yum updateinfo list", now it looks like the description of "yum update-minimal" belongs to the "yum updateinfo" command. See below: added yum commands are: yum update-minimal This works like the update command, but if you have the the package foo-1 installed and have foo-2 and foo-3 available with updateinfo.xml then update-minimal will update you to foo-3. yum updateinfo info yum updateinfo list yum updateinfo summary Package version: yum-utils-1.1.30-14.el6