From owner-freebsd-doc Wed Mar 13 9:30:23 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr4.ruhr.de [212.23.134.2]) by hub.freebsd.org (Postfix) with SMTP id 166B837B404 for ; Wed, 13 Mar 2002 09:30:09 -0800 (PST) Received: (qmail 20068 invoked by uid 10); 13 Mar 2002 17:30:00 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.11.6/8.11.2) id g2DHMTc83554 for freebsd-doc@FreeBSD.org; Wed, 13 Mar 2002 18:22:29 +0100 (CET) (envelope-from ue) Date: Wed, 13 Mar 2002 18:22:29 +0100 From: Udo Erdelhoff To: freebsd-doc@FreeBSD.org Subject: Re: cvs commit: src/release/doc/en_US.ISO8859-1/hardware/alpha proc-alpha.sgml Message-ID: <20020313172228.GA90154@nathan.ruhr.de> Mail-Followup-To: freebsd-doc@FreeBSD.org References: <200203131529.g2DFTqj94565@freefall.freebsd.org> <200203131646.g2DGkaU36815@bmah.dyndns.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <200203131646.g2DGkaU36815@bmah.dyndns.org> User-Agent: Mutt/1.3.27i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Wed, Mar 13, 2002 at 08:46:36AM -0800, Bruce A. Mah wrote: > Is there a reference for this particular change? According to the FDP > Primer, is a block element too. This is not a challenge, > but a request for education. :-) Yes, but the purpose of is to contain character data. The commit message was a bit short or even sloppy in this regard. There are two main reasons for this kind of change: a) Try this: seperate the 'create html' and 'fix html' steps of the build process (in other words, run tidy seperatly). Now run tidy, without throwing its output away. Check its messages when it encounters an inside a . It complains and has to slap in extra breaks. b) Try loading the .html file of the old version in Word. Yes, it's a microsoft product but unfortunately, it is the only way I have to check the spelling of the DE version (ispell-de does not handle 8 bit characters, and the German umlauts are 8 bit). You will notice that Word also has massive problems to display the text correctly. If you load the list of supported hardware, you end with text that is just one column wide, the other 79 are indentation. Additionally, there have been a lot cases where similar changes were made to the FAQ, always with the comment 'bad SGML'. > I'm concerned about the added potential for error. I'm not concerned about the "potential" - I fell into this particular trap during my first attempt to translate the list of supported hardware and had to start over. Right now, I do not want to open this can of worms and until I find a technique that can disable several elements with a single change and uses 'good' SGML, the various documents that need this construct are safe. /s/Udo -- "Ich kann rennen wie ein Hirsch!" "Zustoßen wie ein Stier!" "Kämpfen wie ein Löwe!" "Wer sagte 'Saufen wie ein Kamel?'" - Hägar To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message