From owner-cvs-doc@FreeBSD.ORG Wed Dec 6 09:15:16 2006 Return-Path: X-Original-To: cvs-doc@freebsd.org Delivered-To: cvs-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D34E016A47B for ; Wed, 6 Dec 2006 09:15:16 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.191]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5ECB743CB6 for ; Wed, 6 Dec 2006 09:14:30 +0000 (GMT) (envelope-from niclas.zeising@gmail.com) Received: by nf-out-0910.google.com with SMTP id x37so474189nfc for ; Wed, 06 Dec 2006 01:15:13 -0800 (PST) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=a+WBMxs0Zg14lqFKPz+76xUv0jEBeQuCaHCVULqZz62eDwkMvoYghbVd6WIPcIf0HG1w4QNhl9q5VaNqqNoapqq1m8Z5lXhA61Ptrsqn8gZLm7BT5R+878cwCdQt6rTv7hgxSzwQd1gc18opIPftO1h6Zop3wLNi0D/pGd8wU/A= Received: by 10.49.57.14 with SMTP id j14mr1869798nfk.1165396513538; Wed, 06 Dec 2006 01:15:13 -0800 (PST) Received: by 10.48.12.15 with HTTP; Wed, 6 Dec 2006 01:15:13 -0800 (PST) Message-ID: Date: Wed, 6 Dec 2006 10:15:13 +0100 From: "Niclas Zeising" In-Reply-To: <20061205203738.251FD45042@ptavv.es.net> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <20061205161214.GB3357@kobe.laptop> <20061205203738.251FD45042@ptavv.es.net> Cc: Doug Barton , cvs-doc@freebsd.org, Dmitry Morozovsky , cvs-all@freebsd.org, Giorgos Keramidas , doc-committers@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/install chapter.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Dec 2006 09:15:16 -0000 [Send to list as well] On 12/5/06, Kevin Oberman wrote: > > Date: Tue, 5 Dec 2006 18:12:14 +0200 > > From: Giorgos Keramidas > > Sender: owner-cvs-all@freebsd.org > > > > > > > > On 2006-12-05 13:53, Dmitry Morozovsky 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 > > > 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. > > [snip patch] > > > > 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? > > CIDR format is specified as address/length, so 128.0.0.0/18 is the only > sanctioned way to specify this per RFCs. The fact that Cisco routers > still require the crufty masks and wildcard bits not withstanding. > > Juniper routers use only proper CIDR syntax. > > FreeBSD will accept either for IPv4 (ifconfig(8)). > > In the world of IPv6, only CIDR notation is used, even by Cisco. > > We really should only be used CIDR notation unless we are explaining the > legacy use of masks. Class A/B/C has been obsolete for almost a decade > and really, really should go away. > Maybe we should mention somewhere that the old class A/B/C networks have been obsoleted by CDIR and not simply remove all references to it. I also think we should explain a bit about how CDIR works, as someone suggested. You can also point people to http://www.3com.com/other/pdfs/infra/corpinfo/en_US/501302.pdf which explains a lot about CDIR, subnetting and whatnot. Just some thoughts. //Niclas --