Bug 730724

Summary:	Discrepancy with SWAP field description on top man page
Product:	Red Hat Enterprise Linux 5	Reporter:	Aaron Ogburn <aogburn>
Component:	procps	Assignee:	Jaromír Cápík <jcapik>
Status:	CLOSED ERRATA	QA Contact:	Martin Kyral <mkyral>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	5.4	CC:	albert, bnater, chorn, jaeshin, mkyral, ovasik, pschiffe
Target Milestone:	rc	Keywords:	ManPageChange
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:	procps-3.2.7-19	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-01-08 07:32:48 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Aaron Ogburn 2011-08-15 14:24:03 UTC

Description of problem:

SWAP is described as "The swapped out portion of a task's total virtual memory image".  This isn't the best description as it may lead one to expect the value of SWAP represents the amount of actual swap space the process is using as reported by other commands such as 'free -m'.  This isn't the case however.  Could this description be improved to prevent this misconception?


Steps to Reproduce:
1. man top
2. /SWAP

Comment 1 Peter Schiffer 2011-10-19 10:44:18 UTC

top man page is part of the procps package, so changing to the correct component

Comment 3 RHEL Program Management 2012-04-19 13:27:23 UTC

This request was evaluated by Red Hat Product Management for inclusion
in a Red Hat Enterprise Linux release.  Product Management has
requested further review of this request by Red Hat Engineering, for
potential inclusion in a Red Hat Enterprise Linux release for currently
deployed products.  This request is not yet committed for inclusion in
a release.

Comment 4 Jaromír Cápík 2012-07-03 13:40:23 UTC

Hello Aaron.

I'm changing the description to match the latest procps-ng upstream manual.

------------------------------------------------------
SWAP
The non-resident portion of a task's address space.
------------------------------------------------------

If you have any other suggestions, then let me know.

Thank you.

Regards,
Jaromir.

Comment 8 errata-xmlrpc 2013-01-08 07:32:48 UTC

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.

http://rhn.redhat.com/errata/RHBA-2013-0062.html