From owner-cvs-all Tue Apr 6 16:33:44 1999 Delivered-To: cvs-all@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 8162615453 for ; Tue, 6 Apr 1999 16:33:40 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.2/8.9.2) id AAA07791; Wed, 7 Apr 1999 00:31:21 +0100 (BST) (envelope-from nik) Date: Wed, 7 Apr 1999 00:31:21 +0100 From: Nik Clayton To: Greg Lehey Cc: Nik Clayton , cvs-all@freebsd.org Subject: Re: cvs commit: doc/en/handbook/kerneldebug chapter.sgml Message-ID: <19990407003121.A7109@catkin.nothing-going-on.org> References: <199904060126.SAA99319@freefall.freebsd.org> <19990406235936.A1494@catkin.nothing-going-on.org> <19990407083605.K2142@lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990407083605.K2142@lemis.com>; from Greg Lehey on Wed, Apr 07, 1999 at 08:36:05AM +0930 Organization: Nik at home, where there's nothing going on Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk 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
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. 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