Bug 1009154

Summary:	The yum man page yum(8) contains misformatted 'swap' command examples
Product:	[Fedora] Fedora	Reporter:	"FeRD" (Frank Dana) <ferdnyc>
Component:	yum	Assignee:	Packaging Maintenance Team <packaging-team-maint>
Status:	CLOSED ERRATA	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	19	CC:	admiller, ffesti, firas.alkafri, packaging-team-maint, zpavlas
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Unspecified
Whiteboard:
Fixed In Version:	yum-3.4.3-111.fc19	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-10-08 11:32:34 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:

Description "FeRD" (Frank Dana) 2013-09-17 20:17:35 UTC

Description of problem:
The yum(8) man page documentation for yum's 'swap' command contains a series of example commands. However, these commands are not properly marked up in the manpage source, resulting in misformatted output.

Version-Release number of selected component (if applicable):
yum-3.4.3-106.fc19.noarch

Actual results:
============
Examples:

swap  foo  bar  swap -- remove foo -- install bar swap foo group install bar-grp swap -- group remove foo-grp  --  group  install bar-grp
============

Expected results:
============
Examples:

swap foo bar
swap -- remove foo -- install bar
swap foo group install bar-grp
swap -- group remove foo-grp -- group install bar-grp
============

Additional info:
Looking at the troff source in /usr/share/man/man8/yum.8, the list of examples is (un)formatted in the source (lines 372-375) thus:

swap foo bar
swap -- remove foo -- install bar
swap foo group install bar-grp
swap -- group remove foo-grp -- group install bar-grp

Using similar lists from elsewhere in the source as an example, the commands should be marked up as:

.br
.I \fR swap foo bar
.br
.I \fR swap -- remove foo -- install bar
.br
.I \fR swap foo group install bar-grp
.br
.I \fR swap -- group remove foo-grp -- group install bar-grp
.br

Comment 1 Zdeněk Pavlas 2013-09-19 12:26:45 UTC

Thanks, fixed in HEAD.

Comment 2 Fedora Update System 2013-10-07 11:14:05 UTC

yum-3.4.3-111.fc19 has been submitted as an update for Fedora 19.
https://admin.fedoraproject.org/updates/yum-3.4.3-111.fc19

Comment 3 Fedora Update System 2013-10-08 11:32:34 UTC

yum-3.4.3-111.fc19 has been pushed to the Fedora 19 stable repository.  If problems still persist, please make note of it in this bug report.