On Friday, 28 January 2022 21:29:35 GMT Dave Kemper wrote: > As a side issue, it looks like the .pdfinfo macro mentioned in this > thread is un(der)documented. > > It's documented in the pdfmark documentation > (contrib/pdfmark/pdfmark.ms), but it seems to apply to any document > rendered with groff's -Tpdf option, not just ones using the pdfmark > package, as the macro itself is defined in pdf.tmac. Comments in this > tmac file give a usage statement and examples for .pdfinfo, but this > is not where users are likeliest to find it. > > It isn't documented in the current gropdf man page, which is where I'd > first think to look. This man page documents a number of PDF-specific > commands recognized by the \X escape, but no macros, although pdf.tmac > defines several that appear intended to be user-facing. > > Am I overlooking something, or is this a documentation shortfall?
The pdfmark.pdf file documents the macros for using pdf features. If you are using -T pdf you don't need to include -mpdfmark, this is documented in the gropdf man page and the pdfmark.pdf is referenced. There are a few subtle differences such as there being no need to call .pdfsync (although no harm if you do), and the -T flag to .pdfbookmark gives a specific target name to the bookmark which can then be used in the -D flag of a .pdfhref L internal link. Also, there is a difference in the way to handle traps (header/footer), which otherwise may be included in a hotspot if the hotspot crosses a page break. This is documented in gropdf man page as .pdfmarksuspend and .pdfmarkrestart, which is an example where 'extra' .pdf commands are defined, which are specific to -Tpdf.
