From owner-cvs-doc@FreeBSD.ORG Sat Jun 30 19:41:28 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 0734216A468 for ; Sat, 30 Jun 2007 19:41:28 +0000 (UTC) (envelope-from chinsan.tw@gmail.com) Received: from an-out-0708.google.com (an-out-0708.google.com [209.85.132.242]) by mx1.freebsd.org (Postfix) with ESMTP id A5C3113C46C for ; Sat, 30 Jun 2007 19:41:27 +0000 (UTC) (envelope-from chinsan.tw@gmail.com) Received: by an-out-0708.google.com with SMTP id c14so283559anc for ; Sat, 30 Jun 2007 12:41:27 -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=Zzg7kzy82TsR2mNNXY7LXr+zEDDT+4Q4N79oSQTaybk5Lp8ChLzx6TM5p/unZu1OQffgWNrz3oTv2t2iEZ5JSYeenzs2JbWczvu9aSJjU/dGgZpyFEvZm7I4beAIdxO8XquFM3IK22kSF3wLAusR8xw9jzVx2xWschiWEOr8fXo= 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=sOolQqaOoLl49MVlE76ZkWrl+D8Va1RthxSRoFwdeihKJNCuL7EYgmDrOzin+Sb6MtZPYr52g5fBH8VIAD9RsXbxqRN/+lqNLsb9kXMOeJCs+9RWGalMuBtKRsE/Ptg4K6EZc9AzFleNcoPMZ353dgptL5q0p3kh/sjyVF00Z4U= Received: by 10.100.177.16 with SMTP id z16mr2866166ane.1183232486037; Sat, 30 Jun 2007 12:41:26 -0700 (PDT) Received: by 10.100.119.4 with HTTP; Sat, 30 Jun 2007 12:41:26 -0700 (PDT) Message-ID: <1f27304c0706301241q39b9e0c3t6118c2ed1866549b@mail.gmail.com> Date: Sun, 1 Jul 2007 03:41:26 +0800 From: chinsan To: "Ben Kaduk" In-Reply-To: <47d0403c0706301202w1547401by5c58c6828f69a82f@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> 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:41:28 -0000 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/ Take src/usr.sbin/sysinstall for instance: http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.sbin/sysinstall doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml: http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml > 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 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