bugGNU roff - Bugs: bug #66453, [gropdf] document pdfmark-related...

 
 

bug #66453: [gropdf] document pdfmark-related features

Submitter:  G. Branden Robinson <gbranden>
Submitted:  Sun 17 Nov 2024 04:35:51 AM UTC
   
 
Category:  Driver gropdf Severity:  3 - Normal
Item Group:  Documentation Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Sat 08 Feb 2025 09:18:24 PM UTC, comment #2: 

Here's the correct run line:

.\" Run: pdfmom --roff -ms -M. -mpdfms -msboxes -dpapersz=a4 -tU -P-pa4  Groff-PDF-Features.ms > Groff-PDF-Features.pdf

Deri James <deri>
Group Member
Sat 08 Feb 2025 04:48:12 PM UTC, comment #1: 

Hi Branden,

This is as far as I have got so far, I'd appreciate comments/improvements to the effort. I decided the main audience should be users of the main macro packages, rather than developers of macro packages, since this possibly a wider audience, and I felt Keith's documentation, though more detailed, a bit over complicated.

As you can see from the run command at the top of the file, it is using the pdfms.tmac replacement for Keith's spdf.tmac. The document covers the pdf features in ms that pdfms adds. It's not ready for primetime yet, but it has some advantages, primarily in coping better at adding pdf features to old documents without any changes required. Longer term it might be an idea to incorporate the code into s.tmac when output is pdf, the same as you did with man.

You may have to apply the patch in bug #66653 if you want to avoid your author name becoming just "G." in pdfinfo!

I have also attached gropdf.1 because if you have set up a custom man:/ handler to show all man pages as their pdf versions then the references to gropdf(1) will actually open the man page at the relevent section, using a destination of "gropdf(1)#transition" etc..



(file #56857, file #56858, file #56859, file #56860)

Deri James <deri>
Group Member
Sun 17 Nov 2024 04:35:51 AM UTC, original submission:  

Deri reported these as essential in light of the disappearance of pdfmark.ms from the source tree.

It seems, however, that I lack the wit to do the topic justice, so a volunteer would be welcome!


Were documented in pdfmark.ms

.pdfview
.pdfbookmark
.pdfhref
.pdfinfo
.pdfnote

PDFHREF.VIEW
PDFHREF.VIEW.LEADING
PDFOUTLINE.FOLDLEVEL

Documented in pdf.tmac

Several user configurable strings (e.g. PDFHREF.COLOUR)

Not documented!!

.pdfclean

Documented in gropdf.1

.pdfpagename
.pdfpause
.pdfswitchtopage
.pdftransition
.pdfbackground
.pdfmarkrestart
.pdfmarksuspend

I will try to annotate pdfmark.pdf to indicate specific differences with -
Tpdf.


G. Branden Robinson <gbranden>
Group administrator

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

Attached Files
file #56857:  Groff-PDF-Features.pdf added by deri (45KiB - application/pdf)
file #56858:  pdfms.tmac added by deri (4KiB - application/octet-stream)
file #56859:  Groff-PDF-Features.ms added by deri (22KiB - text/x-troff-ms)
file #56860:  gropdf.1 added by deri (37KiB - application/x-troff-man)

 

Depends on the following items: None found

Items that depend on this one

Digest:
   bug dependencies.

 

Carbon-Copy List
  • -email is unavailable- added by deri (Updated the item)
  • -email is unavailable- added by gbranden (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 5 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2025-02-08 deri Attached File- Added Groff-PDF-Features.pdf, #56857
        Attached File- Added pdfms.tmac, #56858
        Attached File- Added Groff-PDF-Features.ms, #56859
        Attached File- Added gropdf.1, #56860
    2024-11-17 gbranden Dependencies- bugs #65099 is dependent

    Back to the top

    Powered by Savane 3.14-9aa3.
    Corresponding source code