Bug 114806

Summary:	Wording in resources section unclear
Product:	Red Hat Enterprise Linux 3	Reporter:	Ed Bailey <ed>
Component:	rhel-isa	Assignee:	Ed Bailey <ed>
Status:	CLOSED NEXTRELEASE	QA Contact:	John Ha <jha>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	3.0	CC:	adstrong
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2004-07-21 18:06:12 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 Ed Bailey 2004-02-03 02:08:09 UTC

The wording in each chapter's additional resources section can be
unclear.  For example, a resource could be a man page, yet the
description following that resource implies that the resource is
actually the command:

<command>vmstat(8)</command> man page &mdash; Displays a concise
overview of process, memory, swap, I/O, system, and CPU utilization.

In these cases, it would be better to more explicitly note that the
roles of the resource and the following description:

<command>vmstat(8)</command> man page &mdash; *This* *command*
displays a concise overview of process, memory, swap, I/O, system, and
CPU utilization.

Comment 1 Ed Bailey 2004-05-13 19:25:40 UTC

Move to a standard format there the second part of each description
refers to what the man page does:

shovels(5) -- This document teaches you how to use a garden tool.

Comment 2 Ed Bailey 2004-07-21 18:06:12 UTC

Took a slightly different approach, but the work on this has been
completed...