Re: man Macro Package and pdfmark

[Ingo Schwarze]

Hi Jeff,

Jeff Conrad wrote on Thu, Feb 13, 2020 at 03:45:10PM -0800:

> A major drawback to manual pages formatted using the man macros is the
> lack of bookmarks in a PDF file.  A quick and dirty way to get bookmarks
> appears to be adding
> 
> .am SH
> .pdfbookmark 1 "\&\\$*"
> ..
> .am SS
> .pdfbookmark 2 "\&\\$*"
> ..
> 
> to the beginning of the man page source

Just don't do that.  Never use low-level roff stuff in manual pages,
don't even think about it.  This makes your manual pages non-portable.

If you want bookmark support for PDF output from man(7) files,
that needs to be done in the file an-old.tmac, but in a careful
way that does not cause incompatibilities and that does not
require including any other macro files.  It may be tricky,
but it may well be possible.

Yours,
  Ingo