OpenJade and TeTeX (was: Re: Building the FTP tree (was Re: en_US/books/handbook/book.pd* b0rken))

[Bruce A. Mah]

[Moving doceng@ discussion to doc@ as per suggestion.]

If memory serves me right, Nik Clayton wrote:
> On Mon, Mar 17, 2003 at 03:14:06PM -0800, Bruce A. Mah wrote:
> > > I'm also going to test (probably tomorrow, now) OpenJade with this
> > > environment, to get thumbnails in the PDF output.
> > 
> > You mean bookmarks, right?  None of my OpenJade builds have ever given
> > me thumbnails, but bookmarks work like a charm.
> 
> I did indeed mean bookmarks.  I've just tested it here, and as you say,
> it works like a charm.
> 
> I'm really quite impressed with that.

Yeah.  It looks quite spiffy.

> So the suggestion is two-fold:
> 
>   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.
> 
>   2.  Switch to OpenJade for the build to get bookmarks in the PDF
>       files.
> 
> Thoughts?  We should probably shift this discussion over to doc at .

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?

Once #2 is done, #1 is easy.

From a RE standpoint (er, this RE's standpoint), now is a good time,
since we just finished a release and the next one is two months away.

Bruce.

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.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030408/00c614de/attachment.sig>