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

 
 

bug #55789: 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.

 

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:
   

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 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 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2019-02-27 schwarze Severity3 - Normal => 2 - Minor
        StatusNone => Confirmed
        Assigned toNone => schwarze

    Back to the top


    Powered by Savane 3.5