From swear@blarg.net  Sun Oct 14 11:17:18 2001
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id 66CF037B401
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Oct 2001 11:17:18 -0700 (PDT)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 0F28ABCF2
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Oct 2001 11:17:18 -0700 (PDT)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id LAA03653
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Oct 2001 11:17:17 -0700
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id f9EIGU756974;
	Sun, 14 Oct 2001 11:16:30 -0700 (PDT)
	(envelope-from swear@blarg.net)
Message-Id: <9i669iqe81.69i@localhost.localdomain>
Date: 14 Oct 2001 11:16:30 -0700
From: "Gary W. Swearingen" <swear@blarg.net>
To: FreeBSD-gnats-submit@freebsd.org
Subject: ipfw(8) doesn't explain list versus show.

>Number:         31263
>Category:       docs
>Synopsis:       ipfw(8) doesn't explain list versus show.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    yar
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 14 11:20:00 PDT 2001
>Closed-Date:    Tue Jan 22 02:40:20 PST 2002
>Last-Modified:  Tue Jan 22 02:43:05 PST 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.4-RELEASE i386
>Organization:
none
>Environment:
n/a
================
>Description:

ipfw(8) doesn't explain the difference between list and show
and the "-a" description references a non-existant description
of "show".
================
>How-To-Repeat:
n/a
================
>Fix:

## Add this:
(The show command is the same as the list command with an implied -a.)

## and change "-a" to:
-a      With the list command, show counter values.  With the show com-
        mand, it is redundant.

## patch -d "unknown uncompressed man directory" < this-PR

--- orig-ipfw.8	Thu Aug  9 08:28:29 2001
+++ ipfw.8	Thu Aug  9 09:12:14 2001
@@ -140,6 +140,14 @@
 and
 .Cm list
 commands.
+.Po
+The
+.Cm show
+command is the same as the
+.Cm list
+command with an implied
+.Fl a\&.
+.Pc
 Finally, counters can be reset with the
 .Cm zero
 and
@@ -149,10 +157,11 @@
 The following options are available:
 .Bl -tag -width indent
 .It Fl a
-While listing, show counter values.
-See also the
+With the
+.Cm list
+command, show counter values.  With the
 .Cm show
-command.
+command, it is redundant.
 .It Fl f
 Don't ask for confirmation for commands that can cause problems
 if misused,
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->analyzed 
State-Changed-By: yar 
State-Changed-When: Wed Jan 2 12:16:46 PST 2002 
State-Changed-Why:  
A somewhat different change committed to -current, thanks! 


Responsible-Changed-From-To: freebsd-doc->yar 
Responsible-Changed-By: yar 
Responsible-Changed-When: Wed Jan 2 12:16:46 PST 2002 
Responsible-Changed-Why:  
Luigi asked me to add users' suggestions to the ipfw(8) page. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31263 
State-Changed-From-To: analyzed->closed 
State-Changed-By: yar 
State-Changed-When: Tue Jan 22 02:40:20 PST 2002 
State-Changed-Why:  
Ipfw(8) in both -current and -stable describe "show" now, thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31263 
>Unformatted:
