bugGNU roff - Bugs: bug #54587, [PATCH] mom-pdf.mom: Use '\-' for...

 
 

bug #54587: [PATCH] mom-pdf.mom: Use '\-' for options instead of '-'

Submitter:  Bjarni Ingi Gislason <bjarniig>
Submitted:  Tue 28 Aug 2018 09:54:05 PM UTC
   
 
Category:  Macro package mom Severity:  3 - Normal
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Closed Planned Release:  1.22.4
* Mandatory Fields

Add a New Comment Rich Markup
   

Sun 04 Nov 2018 05:47:23 PM UTC, comment #1: 

You're right, build/contrib/mom/examples/mom-pdf.pdf looks better this way.

Fixed in 8297d001200176f9bf90222c32ffb75141d5c0a7.

G. Branden Robinson <gbranden>
Group administrator
Tue 28 Aug 2018 09:54:05 PM UTC, original submission:  


From ec7e98c076acf7685f6104084b3a329a6d552524 Mon Sep 17 00:00:00 2001
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date: Tue, 28 Aug 2018 21:48:43 +0000
Subject: [PATCH] mom-pdf.mom: Use '\-' for options instead of '-'

  The hyphen (-) is too short a dash to mark names of options and as a
symbol for standard input.

  An en-dash (\[en]) could be used, but '\-' ("minus" in the current
font!) is simpler to type and understand (and is thus used in the
traditional [nt]roff (guessing)).

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 contrib/mom/examples/mom-pdf.mom | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/contrib/mom/examples/mom-pdf.mom b/contrib/mom/examples/mom-pdf.mom
index 3abf053e..dbf76655 100644
--- a/contrib/mom/examples/mom-pdf.mom
+++ b/contrib/mom/examples/mom-pdf.mom
@@ -104,19 +104,19 @@ If not, see:
 .char \[gropdf]           \*[BD]gropdf\*[PREV]
 .char \[grops]            \*[BD]grops\*[PREV]
 .char \[man]              \*[BD]man\*[PREV]
-.char \[-mom]             \*[BD]-mom\*[PREV]
+.char \[-mom]             \*[BD]\-mom\*[PREV]
 .char \[mom]              \*[BD]mom\*[PREV]
-.char \[-mpdfmark]        \*[BD]-mpdfmark\*[PREV]
+.char \[-mpdfmark]        \*[BD]\-mpdfmark\*[PREV]
 .char \[ms]               \*[BD]ms\*[PREV]
 .char \[pdfmom]           \*[BD]pdfmom\*[PREV]
 .char \[pdfroff]          \*[BD]pdfroff\*[PREV]
-.char \[-P-e]             \*[BD]-P-e\*[PREV]
-.char \[-P-p<papersize>]  \*[BD]-P-p<papersize>\*[PREV]
+.char \[-P-e]             \*[BD]\-P\-e\*[PREV]
+.char \[-P-p<papersize>]  \*[BD]\-P\-p<papersize>\*[PREV]
 .char \[ps2pdf]           \*[BD]ps2pdf\*[PREV]
 .char \[psselect]         \*[BD]psselect\*[PREV]
-.char \[-T]               \*[BD]-T\*[PREV]
-.char \[-Tpdf]            \*[BD]-Tpdf\*[PREV]
-.char \[-Tps]             \*[BD]-Tps\*[PREV]
+.char \[-T]               \*[BD]\-T\*[PREV]
+.char \[-Tpdf]            \*[BD]\-Tpdf\*[PREV]
+.char \[-Tps]             \*[BD]\-Tps\*[PREV]
 .\" Strings for inline code
 .ds cod  \E*[CODE]\&\E*[COND]
 .ds codx \E*[CONDX]\E*[CODE off]\&
@@ -177,13 +177,13 @@ when the document is viewed at the screen (see
 Groff provides more than one way to generate PDF documents from
 files formatted with the \[mom] macros.  One is to call \[groff]
 directly, either with
-.COD "groff [-Tps] -mom -m pdfmark doc.mom | ps2pdf - doc.pdf
+.COD "groff [\-Tps] \-mom \-m pdfmark doc.mom | ps2pdf \- doc.pdf
 which pipes output from the \[grops] PostScript driver through
 \[ps2pdf], or
-.COD "groff -Tpdf -mom doc.mom > doc.pdf
+.COD "groff \-Tpdf \-mom doc.mom > doc.pdf
 which uses the native PDF driver, \[gropdf].  Alternatively, one may
 call the wrapper
-.COD "pdfroff -mom -mpdfmark --no-toc doc.mom > doc.pdf
+.COD "pdfroff \-mom \-mpdfmark \-\-no-toc doc.mom > doc.pdf
 A fourth, preferred method is to use
 .PDF_LINK pdfmom SUFFIX , "\[pdfmom]"
 which is strongly recommended since it implements the full range
@@ -530,7 +530,7 @@ If a \[-Tps] option is supplied, \[pdfmom] hands control over to
 \[pdfroff], and both \[groff] and \[pdfroff] options may given.
 The resulting PDF is produced from PostScript output fed into
 \[ghostscript].
-.COD "pdfmom -Tps [pdfroff opts [groff opts]] doc.mom > doc.pdf
+.COD "pdfmom \-Tps [pdfroff opts [groff opts]] doc.mom > doc.pdf
 For either invocation, it is not necessary to add \[-mom] or
 \[-mpdfmark], as these are implied.
 .PP
@@ -579,7 +579,7 @@ only accepts colour definitions in decimal notation.
 .LIST OFF
 .IQ
 .HEADING 1 \
-"Comparison of -Tps\*[FU4]/\*[FU2]-mpdfmark with -Tpdf\*[FU4]/\*[FU2]-mom
+"Comparison of \-Tps\*[FU4]/\*[FU2]\-mpdfmark with \-Tpdf\*[FU4]/\*[FU2]\-mom
 .SP .25v
 .IB
 \[-Tps]\*[FU4]/\*[FU2]\[-mpdfmark]
--
2.18.0


Bjarni Ingi Gislason <bjarniig>

 

(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 gbranden (Updated the item)
  • -email is unavailable- added by bjarniig (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 7 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2018-11-04 gbranden Open/ClosedOpen Closed
    2018-11-04 gbranden StatusIn Progress Fixed
        Planned ReleaseNone 1.22.4
    2018-11-04 gbranden CategoryNone Macro package mom
        Item GroupNone Documentation
        StatusNone In Progress
        Assigned toNone gbranden

    Back to the top

    Powered by Savane 3.13-caa5.
    Corresponding source code