Ingo Schwarze wrote in
<20200214184532.gj92...@athene.usta.de>:
 |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.

Yes, i have already mailed him in private.  It actually takes four
lines of code and produces good results, i could not reproduce his
problems.  I asked him whether he wants to open an issue, i for
myself will add (at least) the four lines when i finally, finally
come to my own roff port.

--steffen
|
|Der Kragenbaer,                The moon bear,
|der holt sich munter           he cheerfully and one by one
|einen nach dem anderen runter  wa.ks himself off
|(By Robert Gernhardt)

Reply via email to