Date: Sun, 1 Jul 2007 03:41:26 +0800 From: chinsan <chinsan.tw@gmail.com> To: "Ben Kaduk" <minimarmot@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 Message-ID: <1f27304c0706301241q39b9e0c3t6118c2ed1866549b@mail.gmail.com> In-Reply-To: <47d0403c0706301202w1547401by5c58c6828f69a82f@mail.gmail.com> References: <200706301812.l5UICVqR068588@repoman.freebsd.org> <47d0403c0706301202w1547401by5c58c6828f69a82f@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 7/1/07, Ben Kaduk <minimarmot@gmail.com> 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 <quote from the bottom of 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 </quote>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1f27304c0706301241q39b9e0c3t6118c2ed1866549b>