[CMake] cmake manpage in pdf with section (subsection, etc) bookmarks and hyperlinks?

[Michael Wild]

On 08/13/2012 04:18 PM, Peng Yu wrote:
> Hi,
> 
> I use the following command to generate the pdf file from cmake
> manpage. But the pdf file does not have bookmarks. Does anybody know a
> way to generated the manual in pdf with bookmarks and possibly
> hyperlinks?
> 
>     man -t "$f" | ps2pdf - > $f.pdf
> 
> 

Install dblatex and then run

cmake --help-full cmake-doc.docbook

to generate DocBook XML output which you then can process with your
favourite tool-chain (e.g. dblatex or the xmlto convenience wrapper).

However, it seems that the XML output does not validate (at least with
CMake 2.8.6 that is...). xmllint really chokes badly on it.

Michael