Date: Sat, 30 Jun 2007 14:56:22 -0500 From: "Ben Kaduk" <minimarmot@gmail.com> To: chinsan <chinsan.tw@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: <47d0403c0706301256v27e13c28g6991a15ab3bf68d8@mail.gmail.com> In-Reply-To: <1f27304c0706301241q39b9e0c3t6118c2ed1866549b@mail.gmail.com> References: <200706301812.l5UICVqR068588@repoman.freebsd.org> <47d0403c0706301202w1547401by5c58c6828f69a82f@mail.gmail.com> <1f27304c0706301241q39b9e0c3t6118c2ed1866549b@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 6/30/07, chinsan <chinsan.tw@gmail.com> wrote: > 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/ > 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 > > > <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> > 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?47d0403c0706301256v27e13c28g6991a15ab3bf68d8>