Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 5 Dec 2006 18:12:14 +0200
From:      Giorgos Keramidas <keramida@freebsd.org>
To:        Dmitry Morozovsky <marck@rinet.ru>
Cc:        Doug Barton <dougb@freebsd.org>, doc-committers@freebsd.org, cvs-all@freebsd.org, cvs-doc@freebsd.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/install chapter.sgml
Message-ID:  <20061205161214.GB3357@kobe.laptop>
In-Reply-To: <20061205135214.K72517@woozle.rinet.ru>
References:  <200612041443.kB4EhpBG035838@repoman.freebsd.org> <4574A587.3050903@FreeBSD.org> <20061205135214.K72517@woozle.rinet.ru>

next in thread | previous in thread | raw e-mail | index | archive | help

--VrqPEDrXMn8OVzN4
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On 2006-12-05 13:53, Dmitry Morozovsky <marck@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@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?


--VrqPEDrXMn8OVzN4
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (FreeBSD)

iD8DBQFFdZpe1g+UGjGGA7YRAv/QAKCdNnjFAet/8RKJwta0LabG1k6FOACdEaX2
jem1ruFiztrR46V8c+39zXY=
=mWDL
-----END PGP SIGNATURE-----

--VrqPEDrXMn8OVzN4--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20061205161214.GB3357>