Removing CIDR references (Was: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/install chapter.sgml)

[Doug Barton]

Dmitry Morozovsky wrote:
> On Mon, 4 Dec 2006, Doug Barton wrote:
> 
> DB> >   Modified files:
> DB> >     en_US.ISO8859-1/books/handbook/install chapter.sgml 
> DB> >   Log:
> DB> >   A class C network for 192.168.0.0/24 includes the address
> DB> >   range 192.168.0.0-192.168.0.255, not 192.168.0.0-192.168.255.255
> DB> >   
> DB> >   Submitted by:   Tom Van Looy <tom at ctors.net>
> DB> >   
> DB> >   Revision  Changes    Path
> DB> >   1.338     +1 -1      doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml
> DB> > 
> DB> > http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml.diff?&r1=1.337&r2=1.338&f=h
> DB> > 
> DB> 
> DB> In an ideal world, all references to Class [ABC] networks would
> DB> disappear from our docs, and be replaced by their CIDR equivalents.
> 
> There are suprisingly small number of such places.  What do you think about the 
> patch attached?

Great start! A few comments in line.

> Index: articles/filtering-bridges/article.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/filtering-bridges/article.sgml,v
> retrieving revision 1.20
> diff -u -r1.20 article.sgml
> --- articles/filtering-bridges/article.sgml	8 Aug 2004 13:43:54 -0000	1.20
> +++ articles/filtering-bridges/article.sgml	5 Dec 2006 10:53:35 -0000
> @@ -276,7 +276,7 @@
>        <devicename>xl0</devicename> towards the inside
>        (<acronym>LAN</acronym>).  The bridge machine has the IP <hostid
>        role="ipaddr">1.2.3.4</hostid> (it is not possible that your
> -      <acronym>ISP</acronym> can give you a class A address like this, but for
> +      <acronym>ISP</acronym> can give you an address quite like this, but for
>        our example it is good).</para>
>  
>      <programlisting># Things that we have kept state on before get to go through in a hurry
> Index: books/handbook/install/chapter.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml,v
> retrieving revision 1.338
> diff -u -r1.338 chapter.sgml
> --- books/handbook/install/chapter.sgml	4 Dec 2006 14:43:50 -0000	1.338
> +++ books/handbook/install/chapter.sgml	5 Dec 2006 10:53:35 -0000
> @@ -2356,7 +2356,7 @@
>  
>  	  <listitem>
>  	    <para>The address block being used for this local area
> -	      network is a Class C block
> +	      network is a (historical) Class C block
>  	      (<hostid role="ipaddr">192.168.0.0</hostid> -
>  	      <hostid role="ipaddr">192.168.0.255</hostid>).
>  	      The default netmask is for a Class C network

network is <hostid role="ipaddr">192.168.0.0/24</hostid>, which
encompasses the range from <hostid role="ipaddr">192.168.0.0</hostid>
-<hostid role="ipaddr">192.168.0.255</hostid>).
The default netmask for this network


> Index: books/handbook/ppp-and-slip/chapter.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
> retrieving revision 1.173
> diff -u -r1.173 chapter.sgml
> --- books/handbook/ppp-and-slip/chapter.sgml	30 May 2006 23:08:24 -0000	1.173
> +++ books/handbook/ppp-and-slip/chapter.sgml	5 Dec 2006 10:53:35 -0000
> @@ -760,7 +760,7 @@
>  
>  	    <para>For example, if you have three dialup customers,
>  	      <username>fred</username>, <username>sam</username>, and
> -	      <username>mary</username>, that you route class C networks
> +	      <username>mary</username>, that you route /24 CIDR networks
>  	      for, you would type the following:</para>
>  
>  	    <screen>&prompt.root; <userinput>ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-fred</userinput>
> @@ -827,7 +827,7 @@
>  	      should also contain routing information for each static
>  	      IP user if required.  The line below would add a route
>  	      for the <hostid role="ipaddr">203.14.101.0</hostid>
> -	      class C via the client's ppp link.</para>
> +	      /24 CIDR network via the client's ppp link.</para>

for the <hostid role="ipaddr">203.14.101.0/24</hostid>
network via the client's ppp link.</para>