[PATCH sgml-doctools] Add support for PDF bookmarks in the xorg stylesheet

[Matt Dew]

You're welcome.

Slowly but surely we're cleaning up the documentation.  :)

One of the next step is getting olinks for cross-document linking to
work with xmlto.  I think it's dying because of xmlto's tempdir.

Matt


On Mon, Dec 13, 2010 at 2:11 PM, Alan Coopersmith
<alan.coopersmith at oracle.com> wrote:
> Gaetan Nadon wrote:
>> From: Matt Dew <matt at osource.org>
>>
>> PDF files can optionally include an active table of contents
>> that is displayed alongside the pages in the PDF viewer.
>> These references are called bookmarks.
>>
>> PDF bookmarks are generated using special functions in each XSL-FO processor
>> because XSL cannot produce them directly.
>>
>> Signed-off-by: Gaetan Nadon <memsize at videotron.ca>
>> ---
>>
>> No visible problems when building xorg-docs using fop 0.95.
>> Can you try on some other docs?
>> I suppose with don't have docs with bookmarks as of yet.
>
> I had to upgrade my DocBook XSL stylesheets to 1.70.0 or later (I had 1.69.1)
> and then fop 1.0 automatically produced them for the sections in the table of
> contents.   (The bookmarks are the outline in the left column in Adobe Acrobat
> for quickly jumping to a specific section.)
>
> After that, all the docs I checked looked fine, so I added a note about that
> to the commit log message and pushed.    Thanks to you & Matt for figuring
> this out!  It should make navigation around the large docs like the X11 protocol
> and libX11 specs easier.
>
> --
>        -Alan Coopersmith-        alan.coopersmith at oracle.com
>         Oracle Solaris Platform Engineering: X Window System
>
> _______________________________________________
> xorg-devel at lists.x.org: X.Org development
> Archives: http://lists.x.org/archives/xorg-devel
> Info: http://lists.x.org/mailman/listinfo/xorg-devel
>