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

[Alan Coopersmith]

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