From owner-cvs-all Tue Apr 6 16: 8:19 1999 Delivered-To: cvs-all@freebsd.org Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134]) by hub.freebsd.org (Postfix) with ESMTP id 90A3515740 for ; Tue, 6 Apr 1999 16:08:05 -0700 (PDT) (envelope-from grog@freebie.lemis.com) Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by allegro.lemis.com (8.9.1/8.9.0) with ESMTP id IAA10893; Wed, 7 Apr 1999 08:36:06 +0930 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.9.3/8.9.0) id IAA12706; Wed, 7 Apr 1999 08:36:05 +0930 (CST) Message-ID: <19990407083605.K2142@lemis.com> Date: Wed, 7 Apr 1999 08:36:05 +0930 From: Greg Lehey To: Nik Clayton Cc: cvs-all@freebsd.org Subject: Re: cvs commit: doc/en/handbook/kerneldebug chapter.sgml References: <199904060126.SAA99319@freefall.freebsd.org> <19990406235936.A1494@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.93.2i In-Reply-To: <19990406235936.A1494@catkin.nothing-going-on.org>; from Nik Clayton on Wed, Apr 07, 1999 at 12:00:16AM +0100 WWW-Home-Page: http://www.lemis.com/~grog Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk 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
for? This isn't
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