Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 17 Nov 2003 17:05:41 -0500
From:      Tom Rhodes <trhodes@FreeBSD.org>
To:        "Simon L. Nielsen" <simon@FreeBSD.org>
Cc:        Joe Marcus Clarke <marcus@FreeBSD.org>
Subject:   Re: DocBook help
Message-ID:  <20031117170541.1a05bbb7.trhodes@FreeBSD.org>
In-Reply-To: <20031117215514.GB405@arthur.nitro.dk>
References:  <1068365672.64416.2.camel@shumai.marcuscom.com> <20031109031918.40437858.trhodes@FreeBSD.org> <1068366438.64416.8.camel@shumai.marcuscom.com> <20031116173729.GC5895@electra.cse.Buffalo.EDU> <1069007319.3752.11.camel@shumai.marcuscom.com> <20031117043515.GA16285@electra.cse.Buffalo.EDU> <20031117213239.GA345@jenny.daemon.li> <1069104837.737.71.camel@gyros> <20031117215514.GB405@arthur.nitro.dk>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 17 Nov 2003 22:55:15 +0100
"Simon L. Nielsen" <simon@freebsd.org> wrote:

> On 2003.11.17 16:33:57 -0500, Joe Marcus Clarke wrote:
> > On Mon, 2003-11-17 at 16:32, Josef El-Rayes wrote:
> > > Ken Smith <kensmith@cse.Buffalo.EDU> wrote:
> > > > On Sun, Nov 16, 2003 at 01:28:39PM -0500, Joe Marcus Clarke wrote:
> > > > 
> > > > > Yeah, that's fine.  Thanks!
> > > > 
> > > > How's this?  It's viewable in a very stripped-down web version at:
> > > > 
> > > > http://www.cse.buffalo.edu/~kensmith/FreeBSD/cluster_article.html
> > > > 
> > 
> > Fixed, thanks!
> 
> Now that we are at the little things... :-)
> 
> When you use the trademark entities in the body of the text, then the
> coresponding attributions entities should be used in the header.  Since you
> use sparc and i386 it should be like this:
> 
>     <legalnotice id="trademarks" role="trademarks">
>       &tm-attrib.freebsd;
>       &tm-attrib.intel;
>       &tm-attrib.sparc;
>       &tm-attrib.general;
>     </legalnotice>
> 
> I also noticed that there are some end-of-line whitespace in the SGML
> file which should be removed, and some spaces in the beginnig of lines,
> which should be tabs (see [1]).
> 
> [1] http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style.html#WRITING-STYLE-GUIDE

The primer could probably use a workover, although who has the time.

It should include information on some markup, information about the
trademarks, and a better explination of (and example) of adding a
chapter and using the article framework.  If any of these 'issues'
have been fixed, then please pardon my ignorance.

-- 
Tom Rhodes



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031117170541.1a05bbb7.trhodes>