bugGNU roff - Bugs: bug #52486, groff_hdtbl.7.man: remove .nh/.hy...

 
 

bug #52486: groff_hdtbl.7.man: remove .nh/.hy pairs related to .nf/.fi pairs

Submitter:  Bjarni Ingi Gislason <bjarniig>
Submitted:  Thu 23 Nov 2017 01:08:10 PM UTC
   
 
Category:  Macro - others/general Severity:  2 - Minor
Item Group:  Documentation Status:  Fixed
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Closed Planned Release:  1.23.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Wed 15 Jun 2022 02:34:00 PM UTC, comment #2: 

Fixed independently as noted in comment #1.

G. Branden Robinson <gbranden>
Group administrator
Mon 04 Jan 2021 03:59:57 AM UTC, comment #1: 

I fixed this independently a couple of months ago along with some other changes.


commit dfa7b3108f24c30a1fe7b723d2c7fee7ebbd9671
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Wed Nov 4 21:41:11 2020 +1100

    man pages: Convert .nf/fi/nh/hy nonense to .EX/EE.

    Prompted by John Gardner on the groff mailing list.  I hadn't realized
    how close we were to killing the last of these off.

    Several examples render in roman (Courier roman on typesetters) now
    instead of bold, or in bold only for portions of mixed I/O that are user
    input, just as groff_man_style(7) recommends.

    No textual changes (well, not to _words_) despite severe temptation.

[...]
    * contrib/hdtbl/groff_hdtbl.7.man:
[...]
    * tmac/groff_www.7.man: Replace nf/(nh)/(ft)/.../(ft)/(hy)/fi sequences
      with .EX/EE.  That is what the macros are there for: to turn off
      filling and hyphenation, and select a font family that will stand out
      (Courier) so that all three styles are available, and unlike bold,
      allows character-cell alignment since it is monospaced.  As part of
      groff's unwritten man page style guide, examples are always indented
      as well, which mitigates the absense of a font family change.

    * contrib/hdtbl/groff_hdtbl.7.man: Also use .ne requests in troff mode
      consistently for table examples (two examples already did).  I'm
      conflicted about this; it's against our current portability advice but
      keeps are a pretty basic typographical thing to want/have.  Maybe we
      should bring ms(7)'s .KS/.KE into man(7)--muahahahahaha.  (Less
      radically, we could make .EX and .EE use diversions.)

[...]


G. Branden Robinson <gbranden>
Group administrator
Thu 23 Nov 2017 01:08:10 PM UTC, original submission:  


From f3abe39c173876ba3347e3f2a40a469588bdda14 Mon Sep 17 00:00:00 2001
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date: Thu, 23 Nov 2017 12:53:13 +0000
Subject: [PATCH] groff_hdtbl.7.man: remove .nh/.hy pairs related to .nf/.fi
 pairs

  The request ".hy" is the same as ".hy 1".

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 contrib/hdtbl/groff_hdtbl.7.man | 36 ------------------------------------
 1 file changed, 36 deletions(-)

diff --git a/contrib/hdtbl/groff_hdtbl.7.man b/contrib/hdtbl/groff_hdtbl.7.man
index 573eb6c7..fe2feb1e 100644
--- a/contrib/hdtbl/groff_hdtbl.7.man
+++ b/contrib/hdtbl/groff_hdtbl.7.man
@@ -213,11 +213,9 @@ Either add the line
 .
 .PP
 .nf
-.nh
 .RS
 .CR .mso hdtbl.tmac
 .fi
-.hy
 .RE
 .
 .PP
@@ -229,11 +227,9 @@ package, or add the option
 .
 .PP
 .nf
-.nh
 .RS
 .CR \-m hdtbl
 .fi
-.hy
 .RE
 .
 .PP
@@ -266,14 +262,12 @@ Here we construct a table with only one cell.
 .PP
 .RS
 .nf
-.nh
 .CR .TBL
 .CR .TR
 .CR .TD
 .CI contents of the table cell
 .CR .ETB
 .fi
-.hy
 .RE
 .
 .
@@ -284,7 +278,6 @@ representation is
 .
 .PP
 .nf
-.nh
 .ft CR
 .RS
 +------------------------------------------------------+
@@ -292,7 +285,6 @@ representation is
 +------------------------------------------------------+
 .RE
 .ft
-.hy
 .fi
 .
 .
@@ -301,11 +293,9 @@ Equivalent to the above is the following notation.
 .
 .PP
 .RS
-.nh
 .nf
 .CRI ".TBL .TR .TD \[dq]" "contents of the table cell" "\[dq] .ETB"
 .fi
-.hy
 .RE
 .
 .
@@ -329,13 +319,11 @@ can be written as
 .PP
 .RS
 .nf
-.nh
 .CR ".TBL cols=2"
 .CR ".  TR .TD 1*1 .TD 1*2"
 .CR ".  TR .TD 2*1 .TD 2*2"
 .CR ".ETB"
 .fi
-.hy
 .RE
 .
 .
@@ -347,7 +335,6 @@ representation is
 .
 .PP
 .nf
-.nh
 .ft CR
 .RS
 +--------------------------+---------------------------+
@@ -357,7 +344,6 @@ representation is
 +--------------------------+---------------------------+
 .RE
 .ft
-.hy
 .fi
 .
 .
@@ -386,7 +372,6 @@ Note, however, that this table
 .PP
 .RS
 .nf
-.nh
 .CR ".TBL"
 .CR ".  TR"
 .CR ".    TD"
@@ -402,7 +387,6 @@ Note, however, that this table
 .CR ".      ETB"
 .CR ".ETB"
 .fi
-.hy
 .RE
 .
 .PP
@@ -411,7 +395,6 @@ and this table
 .PP
 .RS
 .nf
-.nh
 .CR ".TBL cols=2"
 .CR ".  TR"
 .CR ".    TD colspan=2"
@@ -423,7 +406,6 @@ and this table
 .CR ".      nop 2*2"
 .CR ".ETB"
 .fi
-.hy
 .RE
 .
 .PP
@@ -437,7 +419,6 @@ The first table looks like
 .
 .PP
 .nf
-.nh
 .ft CR
 .RS
 +------------------------------------------------------+
@@ -449,7 +430,6 @@ The first table looks like
 +------------------------------------------------------+
 .RE
 .ft
-.hy
 .fi
 .
 .PP
@@ -457,7 +437,6 @@ and the second one like
 .
 .PP
 .nf
-.nh
 .ft CR
 .RS
 +------------------------------------------------------+
@@ -467,7 +446,6 @@ and the second one like
 +---------------------------+--------------------------+
 .RE
 .ft
-.hy
 .fi
 .
 .PP
@@ -476,11 +454,9 @@ Here the latter table in a more compact form.
 .PP
 .RS
 .nf
-.nh
 .CR ".TBL cols=2 .TR \[dq].TD colspan=2\[dq] 1*1 1*2"
 .CR ".            TR .TD 2*1 .TD 2*2 .ETB"
 .fi
-.hy
 .RE
 .
 .
@@ -794,12 +770,10 @@ and causes incorrect results.
 .
 .RS
 .IP
-.nh
 .nf
 .CR ".TR .TD 1*1 \[dq].TD 1*2 rowspan=2\[dq] .TD 1*3"
 .CR ".TR \[dq].TD 2*1 colspan=2\[dq]         .TD 2*3"
 .fi
-.hy
 .RE
 .
 .PP
@@ -810,14 +784,12 @@ is
 .PP
 .RS
 .nf
-.nh
 .CR .TBL cols=3
 .CR ".  TR" \[dq].TH colspan=2\[dq] header1+2 .TH header3
 .CR ".  TR" .TD 1*1 .TD 1*2 .TD 1*3
 .CR ".  TR" .TD 2*1 \[dq].TD colspan=2\[dq] 2*2+3
 .CR .ETB
 .fi
-.hy
 .RE
 .
 .PP
@@ -830,7 +802,6 @@ This looks like
 .\}
 .RS
 .nf
-.nh
 +------------------------------+---------------+
 |          header1+2           |    header3    |
 +--------------+---------------+---------------+
@@ -840,7 +811,6 @@ This looks like
 +--------------+-------------------------------+
 .RE
 .ft
-.hy
 .fi
 .
 .PP
@@ -851,7 +821,6 @@ is
 .PP
 .RS
 .nf
-.nh
 .CR .TBL cols=3
 .CR ".  TR"
 .CR ".  TD" 1*1
@@ -863,7 +832,6 @@ is
 .CR ".  TD" 2*3
 .CR .ETB
 .fi
-.hy
 .RE
 .
 .PP
@@ -873,13 +841,11 @@ which looks like
 .ft CR
 .RS
 .nf
-.nh
 +--------------+---------------+---------------+
 | 1*1          | 1+2*2         | 1*3           |
 +--------------+               +---------------+
 | 2*1          |               | 2*3           |
 +--------------+---------------+---------------+
-.hy
 .fi
 .RE
 .ft CR
@@ -1222,12 +1188,10 @@ For example:
 .PP
 .RS
 .nf
-.nh
 .CR ".am pg@end-text"
 .CR ".  t*EM"
 .CR ".."
 .fi
-.hy
 .RE
 .
 .PP
--
2.15.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 (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 7 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-06-15 gbranden CategoryNone Macro - others/general
        Summary[PATCH] groff_hdtbl.7.man: remove .nh/.hy pairs related to .nf/.fi pairs groff_hdtbl.7.man: remove .nh/.hy pairs related to .nf/.fi pairs
    2021-01-04 gbranden Severity3 - Normal 2 - Minor
        StatusNone Fixed
        Assigned toNone gbranden
        Open/ClosedOpen Closed
        Planned ReleaseNone 1.23.0

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code