Re: [Groff] Converting man pages to PDF and links

[Keith Marshall]

On Saturday 01 December 2007 15:32, Andre-John Mas wrote:
> > Are you aware of Keith Marshall's pdfmark macro package?  It's  
> > available
> > under contrib in recent groff versions.  It lets you create a link
> > in PDF files, amongst other things.  I'd guess if you're viewing
> >
> >    file:///home/andre/man/man3/malloc.pdf
> >
> > and it has a link to ../man1/vgrind.pdf then that would work?

Yep.  `.pdfhref L -F path/to/vgrind.pdf -- "text for link hot spot"'

> I wasn't aware of it. Thanks.
>
> Just one question, how would I use it - my groff knowledge is fairly
>   weak.
> I tried:
>
> groff -mpdfmark -c `man -w csh` > out.pdf
>
> but that generated a postscript file without the right formatting.

You'd have to embed the appropriate `.pdfhref ...' markup in the manpage 
source, then format with

  pdfroff --no-toc -man -mpdfmark -c in.man.pdfmark > out.pdf

HTH,
Keith.