Skip site navigation (1)Skip section navigation (2)
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>