bugGNU roff - Bugs: bug #61104, [PATCH] .At 32v should say...

 
 

bug #61104: [PATCH] .At 32v should say "[Version 7] AT&T UNIX/32V", not "Version 32V AT&T UNIX"

Submitter:  None
Submitted:  Wed 01 Sep 2021 04:53:52 PM UTC
   
 
Category:  Macro mdoc Severity:  2 - Minor
Item Group:  Incorrect behaviour Status:  Fixed
Privacy:  Public Assigned to:  schwarze
Open/Closed:  Closed Planned Release:  1.23.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Jump to the original submission

Fri 24 Mar 2023 03:13:05 AM UTC, comment #6: 


commit 21d307286a3f82ba9ddf91fa3fc0a2932a4d7c4c
Author:     наб <nabijaczleweli@nabijaczleweli.xyz>
AuthorDate: Wed Sep 1 19:06:56 2021 +0200
Commit:     Ingo Schwarze <schwarze@openbsd.org>
CommitDate: Sat Sep 4 22:08:25 2021 +0200

    mdoc(7): improve output of .At 32v

    The official designation by AT&T was "UNIX/32V", so use that in the output.
    That also makes sense because "system/architecture" is a widespread
    convention to refer to the port of an operating system to a specific
    architecture, in this case 32V (32bit DEC VAX).

    The former wording "Version 32V AT&T UNIX" was misleading because 32V
    is not a version number.

    Even though UNIX/32V was not officially designated as Version 7 by AT&T,
    prepend "Version 7" because it was in fact a straightforward port of
    Version 7 AT&T UNIX.  That makes it easier to understand for 21st
    century readers of manual pages.

    Patch from nabijaczleweli at nabijaczleweli dot xyz.
    Closes <https://savannah.gnu.org/bugs/?61104>.
    OK gbranden@


G. Branden Robinson <gbranden>
Group administrator
Sat 04 Sep 2021 08:53:10 PM UTC, comment #5: 
Ingo Schwarze <schwarze>
Group Member
Sat 04 Sep 2021 08:44:58 PM UTC, comment #4: 

I think Nab was right and i was wrong; the font change strings only do the traditional .Tn-style size reduction for all caps proper names like AT&T and UNIX, and that is not needed for the architecture name 32V.  So i pushed the original version of the patch, not my modified version.

Regarding "UNIX" versus "Unix", i agree that using "Unix" is better when using it as a generic English word, for example in an expression like "Unix-like operating systems".  But here, we are citing the names of commercial products of AT&T, so we should use their official spelling, and that always used all caps for UNIX as far as i know.  At least the trademark was and is "UNIX", not "Unix".  Besides, all the other output strings print "UNIX", so this one should not diverge.

Commited as 21d30728.

Ingo Schwarze <schwarze>
Group Member
Sat 04 Sep 2021 06:01:54 PM UTC, comment #3: 

There are now two competing versions of the patch in the linked thread, varying in their placement of the font reset \*[doc-str-At].

(A better link to the thread top is http://lists.gnu.org/archive/html/groff/2021-09/msg00001.html -- I'm not sure how the port number snuck into the URL in comment #1, but it breaks the link in links(1).)

Dave <barx>
Group Member
Sat 04 Sep 2021 05:30:35 PM UTC, comment #2: 

I support this patch and further support the "UNIX/V32" (or, better yet, "Unix/V32" outside of fully-capitalized contexts) nomenclature.

G. Branden Robinson <gbranden>
Group administrator
Wed 01 Sep 2021 08:46:39 PM UTC, comment #1: 
Dave <barx>
Group Member
Wed 01 Sep 2021 04:53:52 PM UTC, original submission:  

Currently:

$ printf '.At v7\n.br\n.At 32v' | nroff -mdoc | grep -v '^$'
Version 7 AT&T UNIX
Version 32V AT&T UNIX


But I believe the following:

$ printf '.At v7\n.br\n.At 32v' | nroff -mdoc | grep -v '^$'
Version 7 AT&T UNIX
AT&T UNIX/32V


Or this should hold:

$ printf '.At v7\n.br\n.At 32v' | nroff -mdoc | grep -v '^$'
Version 7 AT&T UNIX
Version 7 AT&T UNIX/32V


32V is a direct port of V7 to the VAX with non-formative new utilities, if any(?); bundling it in with V[1234567] is, at its best, disingenuous, and, at worst, just plainly wrong.

Its manual designation is unanimously Version 1 of UNIX/32V; cf. /usr/man/man0/title:

            Bell Telephone Laboratories, Incorporated
                       Holmdel, New Jersey

                  UNIX/32V PROGRAMMER’S MANUAL

                           Version 1.0

                         February, 1979


/usr/man/man0/title] (TM in superscript):

‐‐

  UNIXTM/32V TIME‐SHARING SYSTEM:

                    UNIX PROGRAMMER’S MANUAL

                      Version 1.0, Volume 1

                         February, 1979

            Bell Telephone Laboratories, Incorporated
                       Holmdel, New Jersey


The basic .At contract is "AT&T UNIX", hence I think either "AT&T UNIX/32V", at the minimum, or "Version 7 AT&T UNIX/32V", following the System/Platform convention and keeping the front a consonant, is best.

32V can be autopsied at http://ftp.okass.net/pub/mirror/minnie.tuhs.org/Distributions/USDL/32V/32v_usr.tar.gz

Previously discussed on mandoc-tech@, Ingo has agreed to follow through with this in mandoc, I hope to push this through NetBSD as well.

Previously seen on Debian #991633.

Anonymous

 

(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 gbranden (Posted a comment)
  • -email is unavailable- added by barx (Posted a comment)
  •  

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

    Date Changed by Updated Field Previous Value => Replaced by
    2023-03-24 gbranden Item GroupBuild/Installation Incorrect behaviour
        Planned ReleaseNone 1.23.0
    2021-09-04 schwarze Severity3 - Normal 2 - Minor
        Item GroupIncorrect behaviour Build/Installation
        StatusNone Fixed
        Assigned toNone schwarze
        Open/ClosedOpen Closed
    2021-09-01 barx Summary.At 32v should say &quot;[Version 7] AT&amp;T UNIX/32V&quot;, not &quot;Version 32V AT&amp;T UNIX&quot; [PATCH] .At 32v should say "[Version 7] AT&T UNIX/32V", not "Version 32V AT&T UNIX"

    Back to the top

    Powered by Savane 3.13-d3ae.
    Corresponding source code