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

[chinsan]

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/

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>