From owner-freebsd-doc@FreeBSD.ORG  Mon Nov 17 13:55:23 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 3A15716A4CE; Mon, 17 Nov 2003 13:55:23 -0800 (PST)
Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk
	[212.242.113.79])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 12E3D43FD7; Mon, 17 Nov 2003 13:55:22 -0800 (PST)
	(envelope-from simon@arthur.nitro.dk)
Received: by arthur.nitro.dk (Postfix, from userid 1000)
	id E7BA110BFAA; Mon, 17 Nov 2003 22:55:15 +0100 (CET)
Date: Mon, 17 Nov 2003 22:55:15 +0100
From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Joe Marcus Clarke <marcus@FreeBSD.org>
Message-ID: <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>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="dTy3Mrz/UPE2dbVg"
Content-Disposition: inline
In-Reply-To: <1069104837.737.71.camel@gyros>
User-Agent: Mutt/1.5.5.1i
cc: Ken Smith <kensmith@cse.Buffalo.EDU>
cc: doc@FreeBSD.org
Subject: Re: DocBook help
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 17 Nov 2003 21:55:23 -0000


--dTy3Mrz/UPE2dbVg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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:
> > >=20
> > > > Yeah, that's fine.  Thanks!
> > >=20
> > > How's this?  It's viewable in a very stripped-down web version at:
> > >=20
> > > http://www.cse.buffalo.edu/~kensmith/FreeBSD/cluster_article.html
> > >=20
>=20
> 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=3D"trademarks" role=3D"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-sty=
le.html#WRITING-STYLE-GUIDE

--=20
Simon L. Nielsen
FreeBSD Documentation Team

--dTy3Mrz/UPE2dbVg
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (FreeBSD)

iD8DBQE/uUPBh9pcDSc1mlERAlzfAJ4wUeQhB2Xl6ctHecwQXhEnA8qqtwCcDSxb
HR+uRJ15OgjwyiTUw30UUt4=
=9L2Z
-----END PGP SIGNATURE-----

--dTy3Mrz/UPE2dbVg--