Date: Fri, 23 Oct 1998 08:43:56 +0930 From: Greg Lehey <grog@lemis.com> To: Nik Clayton <nik@FreeBSD.ORG>, cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: doc/en/handbook README handbook.sgml Message-ID: <19981023084356.F28824@freebie.lemis.com> In-Reply-To: <199810212158.OAA07110@freefall.freebsd.org>; from Nik Clayton on Wed, Oct 21, 1998 at 02:58:42PM -0700 References: <199810212158.OAA07110@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wednesday, 21 October 1998 at 14:58:42 -0700, Nik Clayton wrote:
> nik 1998/10/21 14:58:42 PDT
>
> Modified files:
> en/handbook README handbook.sgml
> Log:
> With the agreement of the Japanese team, a change in the way I'm doing
> things.
>
> I'm now working through from the beginning of the handbook to end,
> correcting as I go. I'll commit in chunks of 5,000 lines (or
> thereabouts).
I've just been looking at printing out the handbook (PostScript
format), and note a number of formatting problems. They're not
urgent, but if you're going through anyway you should be aware of
them. This isn't so much a "please fix" as a "did you know?".
1. No odd/even page breaks (e.g. The part headers can occur on an
even page).
2. Spurious " characters on a line by themselves after some
subheaders (e.g. section 1.4, "The CVS repository").
3. Spurious vertical space after some numbered list items
(e.g. Section 2, "Installing FreeBSD".
4. Some notes in constant width instead of italics (e.g. the "Special
note" in section 2.2.1). I suppose this is a matter of taste, but
I suspect it's also a coincidence.
5. Some examples are wider than the page, and don't wrap. For
example, section 4.2.
6. Use of * for emphasis in some places (4.3.1, "... the mount point
*must* be /cdrom").
Greg
--
See complete headers for address, home page and phone numbers
finger grog@lemis.com for PGP public key
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19981023084356.F28824>