Date: Wed, 7 Apr 1999 00:31:21 +0100 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: Greg Lehey <grog@lemis.com> Cc: Nik Clayton <nik@nothing-going-on.demon.co.uk>, cvs-all@freebsd.org Subject: Re: cvs commit: doc/en/handbook/kerneldebug chapter.sgml Message-ID: <19990407003121.A7109@catkin.nothing-going-on.org> In-Reply-To: <19990407083605.K2142@lemis.com>; from Greg Lehey on Wed, Apr 07, 1999 at 08:36:05AM %2B0930 References: <199904060126.SAA99319@freefall.freebsd.org> <19990406235936.A1494@catkin.nothing-going-on.org> <19990407083605.K2142@lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Apr 07, 1999 at 08:36:05AM +0930, Greg Lehey wrote:
> On Wednesday, 7 April 1999 at 0:00:16 +0100, Nik Clayton wrote:
> > But what's the <blockquote> for? This isn't <blockquote> material. If
> > the formatting needs to be changed then it should be a change made in
> > the stylesheet, not the documentation itself. Changing the markup to
> > affect the presentation is not the right thing to do.
> >
> > Also, some of the other changes you've made to other files are line
> > wrapping changes where the original output would not have been wrapped
> > like this (contrib/chapter.sgml is an example, I think). Again, this
> > might require a rethink of the stylesheets (perhaps dropping the size
> > of the left indent) rather than an alteration of the content to fit.
>
> Yes, maybe we need to rethink some of these when the style sheets are
> fixed.
That being the case, I'd rather concentrate on getting the stylesheets
fixed. I've just spent a year trying to get the Handbook to use
correct (i.e., semantic) markup. I don't want us to immediately start
adding additional markup "because it doesn't look right".
Can you revert those parts of these commits that are just to get it
'looking right' please. Thanks.
> At the moment, it's the only way to get a semblence of correct
> formatting.
Can you give me specifics (like "Page 'x', halfway down the page, runs
off the right margin when formatted as Postscript" or similar) so that I
can check these out and see how to fix them.
The stylesheets should allow us to fix most things without too much
heartache. I'm free most of tomorrow evening, and can devote 3 or 4
hours to it then.
> I have the feeling that DocBook itself is still pretty buggy.
DocBook isn't, but the stylesheets are still in their infancy (relatively
speaking, they're over a year old, but we're probably the project with
the largest document set visibly using it).
As I say, specific problem reports will let me nail this much faster.
Thanks,
N
--
Bagel: The carbohydrate with the hole
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?19990407003121.A7109>