bugGNU roff - Bugs: bug #55467, [PATCH] groff_diff.7.man: Use '\c'...

 
 

bug #55467: [PATCH] groff_diff.7.man: Use '\c' to split lines with "eqn" requests in them

Submitter:  Bjarni Ingi Gislason <bjarniig>
Submitted:  Mon 14 Jan 2019 12:10:19 AM UTC
   
 
Category:  Core Severity:  3 - Normal
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  schwarze
Open/Closed:  Closed Planned Release:  1.23.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Wed 15 Jun 2022 02:13:40 PM UTC, comment #2: 


commit 68a34636bff0197bfe4cc61841dbadc78b11e1b4
Author: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date:   Sun Jan 13 23:18:24 2019 +0000

    groff_diff.7.man: Use '\c' to split input lines containing "eqn" requests.

    The preprocessor "eqn" inserts '.lf' requests into its output.
    If an input line ends with '\' and the next input line starts with
    an "eqn" request, that '.lf' request is printed to the text output
    instead of being executed.

    via https://savannah.gnu.org/bugs/index.php?55467


G. Branden Robinson <gbranden>
Group administrator
Wed 16 Jan 2019 08:15:12 AM UTC, comment #1: 

Abusing eqn(1) to merely format argument placeholders in a manual page is clearly a terrible idea, but cleaning that up is a bit more work than i want to do right now - but anyone else is certainly welcome to remove the gratuitous eqn(1) abuse.

Besides, i might feel tempted to ask whether that .lf amounts to a bug in eqn(1), but that transcends the scope of this ticket.

Even though using '\c' in manual pages is ugly and ought to be avoided as much as possible, Bjarni is right that it's the simplest way to work around the current mess in this manual page, so i pushed his patch in 68a34636bff0197bfe4cc61841dbadc78b11e1b4.

Ingo Schwarze <schwarze>
Group Member
Mon 14 Jan 2019 12:10:19 AM UTC, original submission:  

From 1f75a4ca1e3d2c0905e5ae5dcc9006e49865b1b3 Mon Sep 17 00:00:00 2001
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date: Sun, 13 Jan 2019 23:18:24 +0000
Subject: [PATCH] groff_diff.7.man: Use '\c' to split lines with "eqn" requests
 in them

  The preprocessor "eqn" inserts '.lf' requests into its output.
If a line ends with '\' and the next line starts with output from
"eqn", its first line is added to the text output.

  The escape '\c' ignores request lines as text.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 man/groff_diff.7.man | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index b74b16ce..b5c2e296 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3492,7 +3492,7 @@ delim $$
 .EN
 .
 .TP
-\f[B]Dp\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \
+\f[B]Dp\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \c
 $dx sub n$ $dy sub n$\[rs]n
 Draw a polygon with, for $i = 1 ,..., n+1$, the
 .IR i -th
@@ -3504,7 +3504,7 @@ At the moment, GNU pic only uses this command to generate triangles
 and rectangles.
 .
 .TP
-\f[B]DP\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \
+\f[B]DP\f[R] $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \c
 $dx sub n$ $dy sub n$\[rs]n
 .
 Like
@@ -3537,7 +3537,7 @@ does not depend on this.
 .
 Given a drawing command of the form
 .IP
-\f[B]\[rs]D'\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \
+\f[B]\[rs]D'\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \c
 $x sub n$ $y sub n$\f[B]'\f[R]
 .
 .P
@@ -3581,7 +3581,7 @@ Thus after executing a
 .BR D \~\c
 command of the form
 .IP
-\f[B]D\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \
+\f[B]D\f[I]c\f[R] $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \c
 $x sub n$ $y sub n$\[rs]n
 .
 .P
--
2.20.1


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 (Posted a comment)
  • -email is unavailable- added by schwarze (Posted a comment)
  • -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 5 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-06-15 gbranden CategoryNone Core
    2019-01-16 schwarze StatusNone Fixed
        Assigned toNone schwarze
        Open/ClosedOpen Closed
        Planned ReleaseNone 1.23.0

    Back to the top

    Powered by Savane 3.13-758e.
    Corresponding source code