cvs commit: doc/en_US.ISO8859-1/books/handbook/install chapter.sgml

[Giorgos Keramidas]

On 2006-12-05 13:53, Dmitry Morozovsky <marck at rinet.ru> wrote:
> On Mon, 4 Dec 2006, Doug Barton wrote:
> 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> 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?

I'm not sure I like the appearance of "/24" in flowing text, but the
patch builds fine.

> 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>
>
>  	    <programlisting>fred:
>    add 203.14.101.0 netmask 255.255.255.0 HISADDR

Is there any way we can rephrase this to avoid having to use /24 in the
middle of a sentence.  How do the documentation texts of Cisco and other
networking-related companies, which have a lot of texts about CIDR
address ranges, deal with this?

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-doc/attachments/20061205/0b7f43ab/attachment.pgp