bugGNU roff - Bugs: bug #62676, better document PDF generation

 
 

bug #62676: better document PDF generation

Submitter:  Dave <barx>
Submitted:  Mon 27 Jun 2022 05:53:08 AM UTC
   
 
Category:  Driver gropdf Severity:  1 - Wish
Item Group:  Documentation Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open Planned Release:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Mon 17 Jul 2023 05:05:55 AM UTC, comment #2: 

original submission:

> "Pdfmark.pdf... is the best resource we have for producing pdfs
> with groff, and details the macros and how to use them."


Also of note, pdfmark.pdf is generated from contrib/pdfmark/pdfmark.ms, which bug #63827 places on the chopping block.

Dave <barx>
Group Member
Wed 10 May 2023 08:04:36 AM UTC, comment #1: 

Commit 75950d1c has chipped away a bit at this.  Its log says:

    gropdf(1): Add "Macros" subsection with `pdfinfo`.

Dave <barx>
Group Member
Mon 27 Jun 2022 05:53:08 AM UTC, original submission:  

See this thread for discussion of some of the shortcomings of gropdf documentation: http://lists.gnu.org/r/groff/2022-01/msg00052.html

Select points from this thread:

"Pdfmark.pdf... is the best resource we have for producing pdfs with groff, and details the macros and how to use them."  However, the gropdf man page mentions pdfmark.pdf "in one entry in the list of \X escapes.  This is down in a level of detail that a lot of gropdf users won't necessarily need, whereas at least the .pdfinfo macro... is a document-level control knob.  But users won't know it exists unless they read every entry of the \X list and follow the pointer to pdfmark.pdf."

"And even for those users who do find it, the list item in question is less helpful than it could be: ... It's vague about which pdfmark facilities are available by default in -Tpdf ("a subset" covering "most functionality," with no elaboration about what's included or excluded)."

(Related: bug #60927 covers pdfmark documentation and the pdfroff man page.)

Dave <barx>
Group Member

 

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

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by barx (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.

     

    No changes have been made to this item

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code