From owner-cvs-doc@FreeBSD.ORG Sat Jun 30 19:56:24 2007 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 F001A16A46D for ; Sat, 30 Jun 2007 19:56:23 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: from py-out-1112.google.com (py-out-1112.google.com [64.233.166.180]) by mx1.freebsd.org (Postfix) with ESMTP id 8D44A13C480 for ; Sat, 30 Jun 2007 19:56:23 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: by py-out-1112.google.com with SMTP id u77so2058399pyb for ; Sat, 30 Jun 2007 12:56:23 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=XV1BztWPqibeB5iJHiCr0Et0ptP4lqG6cx2Vld+GhpCOP10cfmkX+ADwLOaAd8nAXcaBdSpHG0+EBd9xa3wSGm7X1lN94AB4GE3aDVcCP22g9MzkmV7ds3l8ZHwKTSJaLTM/Fc0xgdK7hgnIwKgE1grEAo8t1xy0nv/zTjYgf7k= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=Efull0HjZO1GtRnwopIful+aZgmPPgNdNNXMFnnB1FSO7GzvEYQECZOzgkXBKPA0K5vCaQPCr/Yj+MuZJ+5X4pfbU2p3uzQJForeDe8FIIA18R8MbINWj2ijt/4pW1oV45UH7+OF7m83qUxYPfuX9WQA+MRGN3z5zGyscPDXPfM= Received: by 10.143.5.21 with SMTP id h21mr260754wfi.1183233382086; Sat, 30 Jun 2007 12:56:22 -0700 (PDT) Received: by 10.143.1.8 with HTTP; Sat, 30 Jun 2007 12:56:22 -0700 (PDT) Message-ID: <47d0403c0706301256v27e13c28g6991a15ab3bf68d8@mail.gmail.com> Date: Sat, 30 Jun 2007 14:56:22 -0500 From: "Ben Kaduk" To: chinsan In-Reply-To: <1f27304c0706301241q39b9e0c3t6118c2ed1866549b@mail.gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <200706301812.l5UICVqR068588@repoman.freebsd.org> <47d0403c0706301202w1547401by5c58c6828f69a82f@mail.gmail.com> <1f27304c0706301241q39b9e0c3t6118c2ed1866549b@mail.gmail.com> Cc: doc-committers@freebsd.org, cvs-doc@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook Makefile txtfiles.ent 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: Sat, 30 Jun 2007 19:56:24 -0000 On 6/30/07, chinsan wrote: > On 7/1/07, Ben Kaduk wrote: > > Thanks! > > > > I was pretty sure that the ``visual kernel configuartion'' was an > > antique, but I didn't have access to a &os; box when I was looking at > > it. > > You can use the CVSweb service to browser any tree and code: > http://www.freebsd.org/cgi/cvsweb.cgi/ > Thanks for the tip -- I've been using this to grab copies of various chapter.sgml files when sending diffs to -doc@ for a while, now. In this particular case, the easiest way to check seemed to be to actually boot up a system, and run /usr/sbin/sysinstall and see if anything shows up -- there are so many ways that a visual kernel configuration could hide in the source that I would be wasting my time (maybe someone else knows more tricks). [sip cvsweb links] > > By the way, I also noticed that (at least in one chapter) we mix > > together using a literal ``FreeBSD'' and ``&os;''; the example I > > counted was approx 150 FreeBSD and 50 &os; -- is there a reason to > > prefer one to the other? The comment in freebsd.ent points out that > > they are very unlikely to be different, but would we really only want > > to turn some instances into links? > > It's probably not worth the repo-churn to make them consistent, I'm > > just curious. > > Fine. :) > IMHO, I think all of they should be consolidated in the Entities(ie: &os;). > > "Entities are a mechanism for assigning names to chunks of content. As > an SGML parser processes your document, any entities it finds are > replaced by the content of the entity. > > This is a good way to have re-usable, easily changeable chunks of > content in your SGML documents. It is also the only way to include one > marked up file inside another using SGML." > http://www.freebsd.org/doc/en/books/fdp-primer/sgml-primer-entities.html > > > http://www.freebsd.org/cgi/cvsweb.cgi/doc/share/sgml/freebsd.ent> > > Revision 1.1: download - view: text, markup, annotated - select for diffs > Fri Jun 8 01:12:28 2001 UTC (6 years ago) by dd > Branches: MAIN > > Introduce &os;, &os.current;, and &os.stable; entities. The names > should speak for themselves. Using these will significantly improve > consistency through the doc tree. Right now--before most of the > documents use these--there are five or six different spellings of > "FreeBSD-STABLE", even in the same document! &os; was added for > completeness. > > Approved by: -doc > > > It always pays to check the cvs logs. . .I'll try and use the entities in the future if I need to. Thanks again, Ben Kaduk