Date: Sun, 12 Jan 2003 15:18:20 +0100 From: Udo Erdelhoff <ue@nathan.ruhr.de> To: freebsd-doc@FreeBSD.ORG Subject: Re: 5.0 release docs (was Re: HEADSUP: doc/ tree tagging) Message-ID: <20030112141819.GC66579@nathan.ruhr.de> In-Reply-To: <20030112103609.GC371@straylight.oblivion.bg> References: <200301100535.h0A5Zqn3023272@intruder.bmah.org> <20030110124620.GB91718@nathan.ruhr.de> <200301101643.h0AGh3cO028415@intruder.bmah.org> <200301102123.h0ALNFIf031693@intruder.bmah.org> <20030110221508.GE91718@nathan.ruhr.de> <200301110435.h0B4Zbx5038652@intruder.bmah.org> <20030111172153.GA375@straylight.oblivion.bg> <200301111736.h0BHaxph047160@intruder.bmah.org> <20030112103609.GC371@straylight.oblivion.bg>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi, On Sun, Jan 12, 2003 at 12:36:10PM +0200, Peter Pentchev wrote: > Actually, I think it would be best to do it before 5.0, if possible. I think nobody around here doubts that adding the id attributes is a bad thing but everybody here agrees that the timing could not be worse. The arguments in favour of adding the id attributes are equally valid for all the translated versions; perhaps even more so, because 5.0 is the first major with a more-or-less complete DE handbook (and there are other teams who have their big day with 5.0-RELEASE, as well). > Still, I realize that I may have lingered a bit too much in looking into > this and pushing for this change. I will send a patch later today, and > then we can see if it is reasonable to include it into the 5.0 release. IMNSO opinion, just do it right now. This will give the translation teams something 18 hours to catch up. And even if we need a little longer, we can always slide the tags (doc/ is not as critical as src/ and has historically always been tagged somewhat later). One part of this patch should be a small but important change to the Makefile for the Release Notes web build: www/*/relnotes/Makefile: - FORMATS=html\ html-split \ + FORMATS=html \ The reasons should be obvious. No part of the release notes web version uses or references the split html files. I am currently testing this patch with a local build; if the results pass muster, this will go into the tree for de_DE before 5.0. Just in case. And once all the id attributes have been added, somebody with root access to nwww should run a find $DOCROOT -name 'x*.html' -delete shortly before a build. Yes, this will screw up the X11 section of the handbook (among others), but this the only way to remove all the bit-rotting x*.html files. /s/Udo -- He who findeth sensuous pleasures in the bodies of lush, hot, pink damsels is not righteous, but he can have a lot more fun. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030112141819.GC66579>