Bug 150736

Summary: [handbook] ipfw docs: rule number is optional, not mandatory
Product: Documentation Reporter: Rebecca Cran <bcran>
Component: Books & ArticlesAssignee: Ryusuke SUZUKI <ryusuke>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Rebecca Cran freebsd_committer freebsd_triage 2010-09-19 20:20:01 UTC 
In http://www.freebsd.org/doc/handbook/firewalls-ipfw.html section 30.6.5.1.2 says that the rule number is mandatory:

Each rule has to have a rule number to go with it.

The rule number is actually optional.

Also, in 30.6.5 "TCP/IP" is shown as an acrynym but the title is empty: 

Each <acronym class="ACRONYM" title="">TCP/IP</acronym> service

How-To-Repeat: Visit http://www.freebsd.org/doc/handbook/firewalls-ipfw.html
Comment 1 Gabor Pali freebsd_committer freebsd_triage 2010-09-19 20:41:55 UTC 
Responsible Changed
From-To: freebsd-doc->pgj

Grab.
Comment 2 Gabor Pali freebsd_committer freebsd_triage 2010-11-28 12:30:41 UTC 
Responsible Changed
From-To: pgj->freebsd-doc

Back to the pool.
Comment 3 Ryusuke SUZUKI freebsd_committer freebsd_triage 2011-04-06 17:25:04 UTC 
Responsible Changed
From-To: freebsd-doc->ryusuke

I'll take this.
Comment 4 Ryusuke SUZUKI freebsd_committer freebsd_triage 2011-04-11 14:43:41 UTC 
Hi, Bruce-san,

Thanks for reporting docs/150736.

How about follwoing change for the description about 30.6.5.1.2 RULE_NUMBER ?

  Each rule has to have a rule number to go with it.

 ->

  Each rule is associated with a rule_number in the range 1..65535.


This sentence is taken from ipfw(8) :)

I will commit this patch on Apr. 14, if you have no objection.

Regards,
  Ryusuke

--------------------------------------------------------------------
@@ -2483,8 +2483,8 @@
 	<sect4>
 	  <title>RULE_NUMBER</title>
 
-	  <para>Each rule has to have a rule number to go with
-	    it.</para>
+	  <para>Each rule is associated with a rule_number in the range
+	    1..65535.</para>
 	</sect4>
 
 	<sect4>
Comment 5 dfilter service freebsd_committer freebsd_triage 2011-04-14 15:35:59 UTC 
ryusuke     2011-04-14 14:35:46 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/firewalls chapter.sgml 
  Log:
  Update the description of RULE_NUMBER.
  
  PR: docs/150736
  Reported by: brucec@
  
  Revision  Changes    Path
  1.96      +2 -2      doc/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 6 Ryusuke SUZUKI freebsd_committer freebsd_triage 2011-04-15 13:49:54 UTC 
State Changed
From-To: open->closed

Committed. Thanks! 

With regard to the title attribute of the acronym entity, 
this attribute is not used in the FreeBSD handbook.