From owner-freebsd-doc@FreeBSD.ORG Sat Apr 19 10:49:42 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 8D95A37B401; Sat, 19 Apr 2003 10:49:42 -0700 (PDT) Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id 61CC043FD7; Sat, 19 Apr 2003 10:49:41 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by sccrmhc03.attbi.com (sccrmhc03) with ESMTP id <2003041917494000300545dne>; Sat, 19 Apr 2003 17:49:40 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h3JHndxV053505; Sat, 19 Apr 2003 10:49:39 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Message-Id: <200304191749.h3JHndxV053505@bmah.dyndns.org> X-Mailer: exmh version 2.6.3 04/04/2003 with nmh-1.0.4 To: Hiroki Sato In-Reply-To: <20030420.020436.102903006.hrs@eos.ocn.ne.jp> References: <20030414.053436.95910003.hrs@eos.ocn.ne.jp> <20030419.204208.38720452.hrs@eos.ocn.ne.jp> <200304191540.h3JFeSxV052609@bmah.dyndns.org> <20030420.020436.102903006.hrs@eos.ocn.ne.jp> Comments: In-reply-to Hiroki Sato message dated "Sun, 20 Apr 2003 02:04:36 +0900." From: bmah@FreeBSD.org (Bruce A. Mah) X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_1116516253P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Sat, 19 Apr 2003 10:49:39 -0700 Sender: bmah@employees.org cc: bmah@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: suggestion for adding a l10n-capable doc-format navi X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: bmah@FreeBSD.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 19 Apr 2003 17:49:42 -0000 --==_Exmh_1116516253P Content-Type: text/plain; charset=us-ascii If memory serves me right, Hiroki Sato wrote: > bmah> Random thought: I wonder if it'd have been better to leaving it defaul > t > bmah> to "WITH_DOCFORMAT_NAVI_LINK?=NO" and then explicitly setting > bmah> "WITH_DOCFORMAT_NAVI_LINK=YES" in the Web site build, the release build > bmah> doc.1 target, etc. The case I am thinking of is that if someone builds > bmah> an html version only (the default), they'll get a dangling link to a > bmah> non-existant (or stale) html-split version. > > Yes, you have got a point. I made another patch that makes the link > be generated only when ${FORMATS} includes both of "html" and "html-split," > and "WITH_DOCFORMAT_NAVI_LINK=YES." OK. I *think* this is better. This will make it more conservative about adding the navi-link, but it will give it to us whenever we know that we have both versions available. (Plus we can still override it if for some reason we need to do this.) > In the current doc.docbook.mk > WITH_FOO=NO does not work properly, but the patch fixes it, too. Hmmm...it looks to me like with the other (already existing) variables, we don't care what their value is. The convention here seems to be that if WITH_FOO is defined, we want FOO regardless of what the value was. Does anyone know if anything depends on the old behavior? Thanks! Bruce. --==_Exmh_1116516253P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE+oYwz2MoxcVugUsMRAlI7AKCenaIWMfjInriKoqn4QEBB41K3JACcD5uo K1y4oRw1QfbQOOXyIBS0Z7c= =xSnw -----END PGP SIGNATURE----- --==_Exmh_1116516253P--