Bug 47705

Summary: wc(1) manpage has poor explanations.
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Gary W. Swearingen 2003-01-31 05:00:24 UTC 
1) The wc(1) manpage has poor explanations, particularly the definitions of
lines and words.

2) The manpage doesn't explain that only the latter of -c & -m is used.

3) The first paragraph is too big and unorganized. (Better to give
general description, then explanations of lines, words, chararacters.)

4) The manpage refers users to a programmer's manpage.  (Better to just
say what the command does, since it's not hard.  A second reference to
the programmer's manpage can be left in the COMPATIBILITY section and
there's no longer any need for a "See Also" section.)

5) There are several other minor problems. (See patch.)
================

Fix: Patch this:
.\" $FreeBSD: src/usr.bin/wc/wc.1,v 1.6.2.4 2002/08/25 02:47:04 tjr Exp $
with this:
How-To-Repeat: n/a
================
Comment 1 Tom Rhodes freebsd_committer freebsd_triage 2005-02-23 06:20:47 UTC 
State Changed
From-To: open->patched

Different version of the patch committed, we cannot remove the SEE ALSO section when it's useful. 
I've also made some other minor changes.  Thanks!
Comment 2 Tom Rhodes freebsd_committer freebsd_triage 2005-02-23 06:20:47 UTC 
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me, MFC pending.
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2005-02-23 22:41:17 UTC 
State Changed
From-To: patched->closed

MFC complete, switch to closed.