cvs commit: doc/en_US.ISO8859-1/books/handbook Makefile txtfiles.ent doc/en_US.ISO8859-1/books/handbook/install chapter.sgml

[Ben Kaduk]

On 6/30/07, chinsan <chinsan.tw at gmail.com> wrote:
> On 7/1/07, Ben Kaduk <minimarmot at 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