bugGNU troff - Bugs: bug #55789, [PATCH] tmac/doc-syms-u: Some...

 
 

bug #55789: [PATCH] tmac/doc-syms-u: Some abbreviations are missing.

Submitted by:  Bjarni Ingi Gislason <bjarniig>
Submitted on:  Wed 27 Feb 2019 03:00:10 AM UTC  
 
Category:  Macro - mdoc Severity:  2 - Minor
Item Group:  Warning/Suspicious behaviour Status:  Confirmed
Privacy:  Public Assigned to:  Ingo Schwarze <schwarze>
Open/Closed:  Open Planned Release:  None

Add a New Comment (Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Sun 02 Feb 2020 09:21:50 PM UTC, comment #3: 

  I forgot to put the patch in the attachment.
  The line numbers are (could be) different from the master copy.

(file #48335)

Bjarni Ingi Gislason <bjarniig>
Sat 01 Feb 2020 10:58:13 PM UTC, comment #2: 


  Following is still used in "mdoc.7" from "mandoc-1.14.5" (10th March 2019)

Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z

<mdoc.7>: mdoc warning: .St: Unknown standard abbreviation '-susv1' (#2402)
              Please refer to the groff_mdoc(7) manpage for a
              list of available standard abbreviations.
<mdoc.7>: mdoc warning: .St: Unknown standard abbreviation '-xsh4.2' (#2411)
              Please refer to the groff_mdoc(7) manpage for a
              list of available standard abbreviations.
<mdoc.7>: mdoc warning: .St: Unknown standard abbreviation '-susv4' (#2473)
              Please refer to the groff_mdoc(7) manpage for a
              list of available standard abbreviations.

  These strings are defined in "st.c" and only used in "mdoc.7".

  The simplest fix is to define them where the other strings are
(tmac/doc-syms-u):

From 187d702f3cb7193228194c94aa3a4c944846b2b5 Mon Sep 17 00:00:00 2001
From: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Date: Sat, 1 Feb 2020 22:32:29 +0000
Subject: [PATCH] doc-syms-u: Add definitions of some standard abbreviations

  Add the following definition for "susv1", "susv4", and "xsh4.2"

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
tmac/doc-syms-u | 6 ++++++
1 file changed, 6 insertions(+)

diff --git a/tmac/doc-syms-u b/tmac/doc-syms-u
index 7113f722..b86011cf 100644
--- a/tmac/doc-syms-u
+++ b/tmac/doc-syms-u
@@ -662,10 +662,14 @@
.as doc-str-St--iso9945-2-93   " (\*[Lq]\)\*[Px]\*[doc-str-St].2\*[Rq])
.
.\" X/Open
+.ds doc-str-St--susv1          Version\~1 of the Single \*[doc-Tn-font-size]UNIX\*[doc-str-St] Specification
+.as doc-str-St--susv1          " (\*[Lq]\*[doc-Tn-font-size]SUSv1\*[doc-str-St]\*[Rq])
.ds doc-str-St--susv2          Version\~2 of the Single \*[doc-Tn-font-size]UNIX\*[doc-str-St] Specification
.as doc-str-St--susv2          " (\*[Lq]\*[doc-Tn-font-size]SUSv2\*[doc-str-St]\*[Rq])
.ds doc-str-St--susv3          Version\~3 of the Single \*[doc-Tn-font-size]UNIX\*[doc-str-St] Specification
.as doc-str-St--susv3          " (\*[Lq]\*[doc-Tn-font-size]SUSv3\*[doc-str-St]\*[Rq])
+.ds doc-str-St--susv4          Version\~4 of the Single \*[doc-Tn-font-size]UNIX\*[doc-str-St] Specification
+.as doc-str-St--susv4          " (\*[Lq]\*[doc-Tn-font-size]SUSv4\*[doc-str-St]\*[Rq])
.ds doc-str-St--svid4          System\~V Interface Definition, Fourth Edition
.as doc-str-St--svid4          " (\*[Lq]\*[doc-Tn-font-size]SVID\*[doc-str-St]\^4\*[Rq])
.ds doc-str-St--xbd5           \*[doc-Tn-font-size]X/Open\*[doc-str-St] Base Definitions Issue\~5
@@ -684,6 +688,8 @@
.as doc-str-St--xpg4           " (\*[Lq]\*[doc-Tn-font-size]XPG\*[doc-str-St]\^4\*[Rq])
.ds doc-str-St--xpg4.2         \*[doc-Tn-font-size]X/Open\*[doc-str-St] Portability Guide Issue\~4, Version\~2
.as doc-str-St--xpg4.2         " (\*[Lq]\*[doc-Tn-font-size]XPG\*[doc-str-St]\^4.2\*[Rq])
+.ds doc-str-St--xsh4.2         \*[doc-Tn-font-size]X/Open\*[doc-str-St] System Interfaces and Headers Issue\~4.2
+.as doc-str-St--xsh4.2         " (\*[Lq]\*[doc-Tn-font-size]XSH\*[doc-str-St]\^4.2\*[Rq])
.ds doc-str-St--xsh5           \*[doc-Tn-font-size]X/Open\*[doc-str-St] System Interfaces and Headers Issue\~5
.as doc-str-St--xsh5           " (\*[Lq]\*[doc-Tn-font-size]XSH\*[doc-str-St]\^5\*[Rq])
.
--
2.24.1

Bjarni Ingi Gislason <bjarniig>
Wed 27 Feb 2019 01:04:13 PM UTC, comment #1: 

1) -xsh4.2 is unused in FreeBSD-12.0, NetBSD-8.0, OpenBSD-6.4, and in the Linux man pages project.  It is an alias for a part of an ancient standard that is no longer important.  I should remove it from mandoc rather than having it added to groff.

2) -susv1 is also unused in all four systems.  But given that the original Single UNIX Specification is of considerable historical importance, that the alias -xpg4.2 is widely used, and that the newer versions -susv2 and -susv3 also see some limited use, adding it to groff for completeness may be better than deleting it from mandoc.

3) -susv4 is used in a handful of pages in FreeBSD-12.0.  Using the alias -p1003.1-2008 would probably be better, but i guess breaking those pages would be gratuitious, and besides, -susv4 is the current version of the standard, so i think adding the alias is OK.

If somebody confirms in a comment that adding -susv1 and -susv4 and deleting -xsh4.2 is a reasonable plan, i'll write and push a diff doing that.  Of course, it's an extremely low-priority issue...

Ingo Schwarze <schwarze>
Project MemberIn charge of this item.
Wed 27 Feb 2019 03:00:10 AM UTC, original submission:  


  The manual "mdoc.7" from the "mandoc" (Debian
"[mdocml_1.14.4.orig.tar.gz]") package shows, that some abbreviations
are missing in the "groff" file "tmac/doc-syms-u":

  Command "nroff -ww -mandoc mdoc.7 > /dev/null" :

mdoc warning: .St: Unknown standard abbreviation '-susv1' (#2527)
              Please refer to the groff_mdoc(7) manpage for a
              list of available standard abbreviations.
mdoc warning: .St: Unknown standard abbreviation '-xsh4.2' (#2536)
              Please refer to the groff_mdoc(7) manpage for a
              list of available standard abbreviations.
mdoc warning: .St: Unknown standard abbreviation '-susv4' (#2598)
              Please refer to the groff_mdoc(7) manpage for a
              list of available standard abbreviations.

Bjarni Ingi Gislason <bjarniig>

 

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

Attach Files:
   
   
Comment:
   

Attached Files
file #48335:  groff.bug added by bjarniig (2KiB - application/octet-stream)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by schwarze (Posted a comment)
  • -email is unavailable- added by bjarniig (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2020-10-13 barx Carbon-CopyRemoved 93119 => -
    2020-10-13 barx Summarytmac/doc-syms-u: Some abbreviations are missing. => [PATCH] tmac/doc-syms-u: Some abbreviations are missing.
    2020-02-02 bjarniig Attached File- => Added groff.bug, #48335
    2019-02-27 schwarze Severity3 - Normal => 2 - Minor
        StatusNone => Confirmed
        Assigned toNone => schwarze

    Back to the top


    Powered by Savane 3.5