From charon@labs.gr  Wed Sep 26 04:16:51 2001
Return-Path: <charon@labs.gr>
Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5])
	by hub.freebsd.org (Postfix) with ESMTP id 467E837B418
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 26 Sep 2001 04:16:50 -0700 (PDT)
Received: from hades.hell.gr (patr530-a219.otenet.gr [212.205.215.219])
	by mailsrv.otenet.gr (8.11.5/8.11.5) with ESMTP id f8QBGgY20111
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 26 Sep 2001 14:16:47 +0300 (EEST)
Received: (from charon@localhost)
	by hades.hell.gr (8.11.6/8.11.6) id f8Q8XdV22897;
	Wed, 26 Sep 2001 11:33:39 +0300 (EEST)
	(envelope-from charon)
Message-Id: <200109260833.f8Q8XdV22897@hades.hell.gr>
Date: Wed, 26 Sep 2001 11:33:39 +0300 (EEST)
From: Giorgos Keramidas <charon@labs.gr>
Reply-To: Giorgos Keramidas <charon@labs.gr>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: wrap in <command> the only instance of ipfw that isn't marked up like this in dialup-firewall article
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         30838
>Category:       docs
>Synopsis:       wrap in <command> the only instance of ipfw that isn't marked up like this in dialup-firewall article
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Sep 26 04:20:00 PDT 2001
>Closed-Date:    Wed Sep 26 17:51:57 PDT 2001
>Last-Modified:  Wed Sep 26 17:52:04 PDT 2001
>Originator:     Giorgos Keramidas
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:

System: FreeBSD hades.hell.gr 5.0-CURRENT FreeBSD 5.0-CURRENT #5: Tue Sep 4
  19:49:44 EEST 2001 root@hades.hell.gr:/usr/obj/usr/src/sys/CHARON i386

>Description:

	The attached patch wraps in <command>...</command> the only instance of
	`ipfw' in the running text of the dialup-firewall that is not marked as
	<command> and is not a &man.ipfw.8; entity.

>How-To-Repeat:
>Fix:

--- patch-aa begins here ---
Index: article.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/dialup-firewall/article.sgml,v
retrieving revision 1.15
diff -u -r1.15 article.sgml
--- article.sgml	2 Sep 2001 10:37:26 -0000	1.15
+++ article.sgml	26 Sep 2001 08:30:06 -0000
@@ -279,8 +279,8 @@
 	  <para>This merely means that the maximum logging count for the
 	    rule has been reached.  The rule itself is still working,
 	    but it will no longer log until such time as you reset the
-	    logging counters.  This can be done by simply prefixing the
-	    ipfw command with the <literal>resetlog</literal> option.</para>
+	    logging counters.  This can be done by simply prefixing
+            <command>ipfw</command> with the <literal>resetlog</literal> option.</para>
         </answer>
       </qandaentry>
 
--- patch-aa ends here ---
>Release-Note:
>Audit-Trail:

From: Murray Stokely <murray@FreeBSD.org>
To: Giorgos Keramidas <charon@labs.gr>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/30838: wrap in <command> the only instance of ipfw that isn't marked up like this in dialup-firewall article
Date: Wed, 26 Sep 2001 14:46:14 -0700

 --wULyF7TL5taEdwHz
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Wed, Sep 26, 2001 at 11:33:39AM +0300, Giorgos Keramidas wrote:
 >  	  <para>This merely means that the maximum logging count for the
 >  	    rule has been reached.  The rule itself is still working,
 >  	    but it will no longer log until such time as you reset the
 > -	    logging counters.  This can be done by simply prefixing the
 > -	    ipfw command with the <literal>resetlog</literal> option.</para>
 > +	    logging counters.  This can be done by simply prefixing
 > +            <command>ipfw</command> with the <literal>resetlog</literal>=
  option.</para>
 >          </answer>
 
   This sentence doesn't make any sense to me.  The correct answer to
 the question is to run the ipfw command with the 'resetlog'
 argument, but that is a very confusing way to describe it.  Also, we
 should probably mention the bumping up of the log limit in the kernel
 configuration that is discussed earlier in this article.  I agree that
 we should add the markup to the ipfw command, but it doesn't do much
 good if the sentence doesn't make sense in the first place.  How about
 this :=20
 
 "You can reset the logging counters with the <command>ipfw
 resetlog</command> command.  Alternatively, you may increase the log
 limit in your kernel configuration file by increasing the
 <option>IPFIREWALL_VERBOSE_LIMIT</option> option."
 
 Sound good?
 
       - Murray
 --wULyF7TL5taEdwHz
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.6 (SunOS)
 Comment: For info see http://www.gnupg.org
 
 iD8DBQE7skyltNcQog5FH30RAuTRAJwKSsg6OVX3t1J7y9Vr+DcSCFOqJQCfZFOP
 ENREIN6dwR9nHCAowGbf4yg=
 =lOaQ
 -----END PGP SIGNATURE-----
 
 --wULyF7TL5taEdwHz--

From: Giorgos Keramidas <charon@labs.gr>
To: Murray Stokely <murray@FreeBSD.ORG>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/30838: wrap in <command> the only instance of ipfw that isn't marked up like this in dialup-firewall article
Date: Thu, 27 Sep 2001 00:58:01 +0300

 --R3G7APHDIzY6R/pk
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Murray Stokely <murray@FreeBSD.org> wrote:
 >=20
 >   This sentence doesn't make any sense to me.
 
 Doesn't make sense to me either, and I wanted to double check before sugges=
 ting
 a replacement (my kernel does not have ipfw support).  Especially that
 'prefixing' thing sounds awfuly confusing.  Feel free to change it, the
 following looks a lot better:
 
 > How about this :=20
 >=20
 > "You can reset the logging counters with the <command>ipfw
 > resetlog</command> command.  Alternatively, you may increase the log
 > limit in your kernel configuration file by increasing the
 > <option>IPFIREWALL_VERBOSE_LIMIT</option> option."
 
 -giorgos
 
 
 --R3G7APHDIzY6R/pk
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.6 (FreeBSD)
 
 iD8DBQE7sk9o1g+UGjGGA7YRAofNAJ4/KXHpTJ9zsF9CWeXJuNMhpbzMEwCgu8S2
 kfYwAZtbY84biOK8IKd+e6U=
 =I4UF
 -----END PGP SIGNATURE-----
 
 --R3G7APHDIzY6R/pk--
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Wed Sep 26 17:51:57 PDT 2001 
State-Changed-Why:  
fixed, thanks! 


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