From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 04:10:10 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1EFB416A4CE for ; Wed, 31 Dec 2003 04:10:10 -0800 (PST) Received: from mail.ruhr.de (in-ruhr4.ruhr.de [212.23.134.2]) by mx1.FreeBSD.org (Postfix) with SMTP id 0621B43D49 for ; Wed, 31 Dec 2003 04:10:05 -0800 (PST) (envelope-from ue@nathan.ruhr.de) Received: (qmail 23948 invoked by uid 10); 31 Dec 2003 12:10:03 -0000 Received: from nathan.internal (localhost.internal [127.0.0.1]) by nathan.internal (8.12.9/8.12.9) with ESMTP id hBVC9vkM092571; Wed, 31 Dec 2003 13:09:57 +0100 (CET) (envelope-from ue@nathan.internal) Received: (from ue@localhost) by nathan.internal (8.12.9/8.12.9/Submit) id hBVC9u6j092570; Wed, 31 Dec 2003 13:09:56 +0100 (CET) Date: Wed, 31 Dec 2003 13:09:56 +0100 From: Udo Erdelhoff To: Hiroki Sato Message-ID: <20031231120956.GC45118@nathan.ruhr.de> References: <20031230004119.GA19005@nathan.ruhr.de> <20031230.194507.56983609.hrs@eos.ocn.ne.jp> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="xesSdrSSBC0PokLI" Content-Disposition: inline In-Reply-To: <20031230.194507.56983609.hrs@eos.ocn.ne.jp> User-Agent: Mutt/1.4.1i cc: freebsd-doc@FreeBSD.org Subject: Re: doc.common.mk 1.3 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Dec 2003 12:10:10 -0000 --xesSdrSSBC0PokLI Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Morning, On Tue, Dec 30, 2003 at 07:45:07PM +0900, Hiroki Sato wrote: > I understand the problem. As you pointed out, currently > if the pathname does not include "doc" or "www", LANGCODE and > WWW_LANGCODE are not defined properly.=20 uh, no. My point was that a pre-defined LANGCODE is OVERWRITTEN (with a bad value) unless WWW_LANGCODE is not defined. But this is only a symptom of the real problem. The underlying question is: Why do I have to worry at all about www while working on docs? The bar for working on FreeBSD docs is already quite high with all the programs you need. Making it neccessary to think about the www directories raises this bar even higher. And "out-of-tree" builds are more than just substituing "/usr/www" and "/usr/doc" with "/home/ue/www" and "/home/ue/doc", respectivly. For example, everybody who works on more than one version of the release notes (I currently track FIFTEEN versions of them, with more to come) may very well have /usr/doc and /usr/www in their usual places, plus a huge "out-of-tree" chunk consisting of the various /usr/src/release/doc subtrees. Or, to keep things limited to doc/www, to have /usr/www and /usr/doc and their usual places plus an extra for test builds of the web site. I understand the need for some "guess-the-langcode-from-the-path" logic in the current build infrastructure to handle "cd /usr/doc;make" and stuff like that. I am not happy with it (what's so bad about adding LANGCODE?=3D to each Makefile?), but that is another matter. In other words, your patch changes too much and introduces yet another set of variables that developers have to think about. And it links doc and www building together, allthough the two should be separate, clearly violating POLA. /s/Udo --=20 "When faced with a choice between evils, I always pick the one I haven't tried before." -- Mae West --xesSdrSSBC0PokLI Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iQCVAwUBP/K8lEPoh1XnT6hxAQGUZAP8CJw9yeIBB4x/2+BWK87ZVdauhuVqKDs9 7Ukn7Le4NMo1DZ4sMyP/eh0vruEfWDie7IqxpDxh1pHM+QfCgmG1EGHGWbGC/56Z OgvGMoFL1GVjxgFukqBVLpdMvjANUBt1sG4SXzneMEGbVzttaXgYSyA1mTycxgWg UHfk2RWbC4Y= =h2WJ -----END PGP SIGNATURE----- --xesSdrSSBC0PokLI--