Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 7 Apr 1999 08:36:05 +0930
From:      Greg Lehey <grog@lemis.com>
To:        Nik Clayton <nik@nothing-going-on.demon.co.uk>
Cc:        cvs-all@freebsd.org
Subject:   Re: cvs commit: doc/en/handbook/kerneldebug chapter.sgml
Message-ID:  <19990407083605.K2142@lemis.com>
In-Reply-To: <19990406235936.A1494@catkin.nothing-going-on.org>; from Nik Clayton on Wed, Apr 07, 1999 at 12:00:16AM %2B0100
References:  <199904060126.SAA99319@freefall.freebsd.org> <19990406235936.A1494@catkin.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wednesday,  7 April 1999 at  0:00:16 +0100, Nik Clayton wrote:
> On Mon, Apr 05, 1999 at 06:26:25PM -0700, Greg Lehey wrote:
>> grog        1999/04/05 18:26:25 PDT
>>
>>   Modified files:
>>     en/handbook/kerneldebug chapter.sgml
>>   Log:
>>   Tidy up displays so that they fit onto a printed page (sort of).
>>
>>   Revision  Changes    Path
>>   1.12      +5 -4      doc/en/handbook/kerneldebug/chapter.sgml
>
> I've just had a look at this.  The shifting of "...done" down on to its
> own line I can understand (if that's what the output actually looks
> like).
>
> 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.  At the moment, it's the only way to get a semblence of correct
formatting.  I have the feeling that DocBook itself is still pretty
buggy.

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?19990407083605.K2142>