From owner-freebsd-doc@FreeBSD.ORG Tue Apr 8 22:39:27 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 E2C4837B401; Tue, 8 Apr 2003 22:39:26 -0700 (PDT) Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9E7B543FA3; Tue, 8 Apr 2003 22:39:25 -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 <2003040905392400300saka3e>; Wed, 9 Apr 2003 05:39:24 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h395dNs0052747; Tue, 8 Apr 2003 22:39:23 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.9/8.12.9/Submit) id h395dNfZ052746; Tue, 8 Apr 2003 22:39:23 -0700 (PDT) Date: Tue, 8 Apr 2003 22:39:23 -0700 From: "Bruce A. Mah" To: Murray Stokely Message-ID: <20030409053923.GB52499@intruder.bmah.org> References: <7mptovi7wc.wl@black.imgsrc.co.jp> <20030313122030.C25592@freebsdmall.com> <20030314001033.GC72128@clan.nothing-going-on.org> <20030316234847.GA25279@clan.nothing-going-on.org> <20030317223030.GD1051@clan.nothing-going-on.org> <20030317230702.GF1051@clan.nothing-going-on.org> <20030317231406.GA19216@intruder.bmah.org> <20030329130325.GG875@clan.nothing-going-on.org> <20030408170132.GA47828@intruder.bmah.org> <20030408103608.C43794@freebsdmall.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="CdrF4e02JqNVZeln" Content-Disposition: inline In-Reply-To: <20030408103608.C43794@freebsdmall.com> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ cc: doc@freebsd.org cc: Nik Clayton Subject: Re: OpenJade and TeTeX (was: Re: Building the FTP tree (was Re: en_US/books/handbook/book.pd* b0rken)) 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, 09 Apr 2003 05:39:27 -0000 --CdrF4e02JqNVZeln Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Murray Stokely wrote: > On Tue, Apr 08, 2003 at 10:01:32AM -0700, Bruce A. Mah wrote: > > > 1. Remove the hack in the Handbook's PDF build process to use > > > tex, since the new port can handle the size of the Handbook. > > >=20 > > > 2. Switch to OpenJade for the build to get bookmarks in the PDF > > > files. > > >=20 > > > Thoughts? We should probably shift this discussion over to doc@. > >=20 > > The only problem I see with #2 is that it'll probably take a flag day > > to do this. If we switch the doc infrastructure to use OpenJade (with > > or without an override), then existing Jade-based toolchains will > > break. I think the benefits outweigh the costs but I am uncertain how > > best to proceed. Do we give lots of advance warning via multiple > > HEADSUP messages and just go for it? >=20 > As long as we continue to support Jade via 'USE_JADE' or something > similar then this sounds like a good idea to me. OK, that's fair enough. There'll still be kind of a flag day but an easy way for people to deal with it. > > PS. For newcomers: The issue is whether to switch to using OpenJade > > (rather than Jade) for all doc builds. OpenJade is under active > > development, and we are forced to use OpenJade on the 64-bit platforms > > anyways. At one point, there were concerns about OpenJade's ability > > to handle non-English languages, but my impression is that those have > > been resolved. >=20 > It seems many people are generally under the assumption that OpenJade > is under "active" development, but the last I checked that really > wasn't the case. I had some patches to commit and they even gave me > commit access on sourceforge ISTR but there was hardly anyone actually > doing any work. When I've worked with it I have indeed found some > cool new stuff, but I also have found other parts broken that "just > worked" with regular jade. Interesting. Do you remember what was broken? Both of them seem to work fine for the release documentation but that's pretty simple compared to some of the stuff that you did with the print Handbook. > Have they started doing regular releases? Well, in our ports tree, jade's last version upgrade was January 1999. openjade was last upgrade happened in February 2003, to a release from the project made in December 2002 (the prior release before that was January 2002). Admittedly an incomplete history... Actually, now that I look more closely I see mention of a patch to our jade port that's supposed to make it at least compile on sparc64 and ia64. Hmmm. Bruce. --CdrF4e02JqNVZeln Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+k7IL2MoxcVugUsMRAj6PAJ9gC42f4EROz2XdJf7lqTU0LMlwtwCfcbJz KtV4OBETtvHE/ItzFCWO+ps= =sHpx -----END PGP SIGNATURE----- --CdrF4e02JqNVZeln--