From oberman@slan.es.net  Mon Aug 21 01:04:07 2006
Return-Path: <oberman@slan.es.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3E8BD16A4E0
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 21 Aug 2006 01:04:07 +0000 (UTC)
	(envelope-from oberman@slan.es.net)
Received: from slan.es.net (c-67-169-124-157.hsd1.ca.comcast.net [67.169.124.157])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5CCF043D6E
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 21 Aug 2006 01:04:05 +0000 (GMT)
	(envelope-from oberman@slan.es.net)
Received: by slan.es.net (Postfix, from userid 9381)
	id F0F8E5C31; Sun, 20 Aug 2006 18:04:04 -0700 (PDT)
Message-Id: <20060821010404.F0F8E5C31@slan.es.net>
Date: Sun, 20 Aug 2006 18:04:04 -0700 (PDT)
From: Kevin Oberman <oberman@es.net>
Reply-To: Kevin Oberman <oberman@es.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Handbook and man pages for firewalls are inconsistent
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         102334
>Category:       docs
>Synopsis:       Handbook and man pages for firewalls are inconsistent
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    danger
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 21 01:10:09 GMT 2006
>Closed-Date:    Sat Sep 16 22:17:35 GMT 2006
>Last-Modified:  Sat Sep 16 23:00:38 GMT 2006
>Originator:     Kevin Oberman
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
ESent--The Energy Sciences Network
>Environment:
System: FreeBSD slan.es.net 7.0-CURRENT FreeBSD 7.0-CURRENT #21: Sat Aug 12 22:41:34 PDT 2006 root@slan.es.net:/usr/obj/usr/src/sys/IBM-T43 i386

>Description:
The handbook and the man page for firewalls are inconsistent. I
suspect both might be correct, but it would probably be less confusing
if they were consistent. 

The man page recommends adding 'firewall_type="/etc/ipfw.conf"' to
/etc/rc.conf while the handbook call for
'firewall_script="/etc/ipfw.rules"'. The handbook seems more intuitive
to me, but they really should be consistent.
>How-To-Repeat:
	N/A
>Fix:

	Select either method and make man pate and handbook consistent.
>Release-Note:
>Audit-Trail:

From: Daniel Gerzo <danger@FreeBSD.org>
To: bug-followup@FreeBSD.org, oberman@es.net
Cc:  
Subject: Re: docs/102334: Handbook and man pages for firewalls are inconsistent
Date: Sat, 9 Sep 2006 00:04:26 +0200

 Hello Kevin,
 
   Could you please tell me, which man page have you been referring to?
   Note that I have committed a small update to the IPFW chapter of our
   Handbook, which I hope describes the differences between
   firewall_type and firewall_script directives well. Please check
   http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/firewalls-ipfw.html
 
   Let me know if there are any further problems which need to be
   resolved. If no feedback will be received, I will close this PR in
   a week.
 
 -- 
 Best regards,
  Daniel                          mailto:danger@FreeBSD.org
 
Responsible-Changed-From-To: freebsd-doc->danger 
Responsible-Changed-By: danger 
Responsible-Changed-When: Sat Sep 9 09:24:29 UTC 2006 
Responsible-Changed-Why:  
Set me responsible. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=102334 
State-Changed-From-To: open->closed 
State-Changed-By: danger 
State-Changed-When: Sat Sep 16 22:15:43 UTC 2006 
State-Changed-Why:  
No feedback received from Originator, I suspect that the changes I have 
committed to the Handbook clarify the differences good enoguh. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=102334 

From: "Kevin Oberman" <oberman@es.net>
To: Daniel Gerzo <danger@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/102334: Handbook and man pages for firewalls are inconsistent 
Date: Sat, 16 Sep 2006 15:54:14 -0700

 --==_Exmh_1158447254_90174P
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Daniel,
 
 I must apologize for not getting back to you promptly, but I have been
 on vacation and off-line. Just got back and saw your message (buried in
 about 1000). I was hoping to have time to read the updated handbook entry
 before responding, so I did not send an immediate response on Thursday.
 
 I any case, closing the ticket was correct as the current handbook
 discussion odes match the man page and is far clearer than te page at
 the time I submitted the PR.
 
 Again, sorry for the lack of a prompt response and thanks for your work
 on the handbook.
 -- 
 R. Kevin Oberman, Network Engineer
 Energy Sciences Network (ESnet)
 Ernest O. Lawrence Berkeley National Laboratory (Berkeley Lab)
 E-mail: oberman@es.net			Phone: +1 510 486-8634
 Key fingerprint:059B 2DDF 031C 9BA3 14A4  EADA 927D EBB3 987B 3751
 
 > Date: Sat, 9 Sep 2006 00:04:26 +0200
 > From: Daniel Gerzo <danger@FreeBSD.org>
 > 
 > Hello Kevin,
 > 
 >   Could you please tell me, which man page have you been referring to?
 >   Note that I have committed a small update to the IPFW chapter of our
 >   Handbook, which I hope describes the differences between
 >   firewall_type and firewall_script directives well. Please check
 >   http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/firewalls-ipfw.html
 > 
 >   Let me know if there are any further problems which need to be
 >   resolved. If no feedback will be received, I will close this PR in
 >   a week.
 > 
 > -- 
 > Best regards,
 >  Daniel                          mailto:danger@FreeBSD.org
 > 
 
 --==_Exmh_1158447254_90174P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.5 (FreeBSD)
 Comment: Exmh version 2.5 06/03/2002
 
 iD8DBQFFDICWkn3rs5h7N1ERAhD6AKC4ihTTSAKvi+uiY+mOX6CYX1ouEACfeV/P
 d3EWUYeH8tJPzcUQHFJym7c=
 =Z3rf
 -----END PGP SIGNATURE-----
 
 --==_Exmh_1158447254_90174P--
>Unformatted:
