From: Ingo Schwarze <schwarze@usta.de>
Subject: Re: mandoc: add POSIX 2024
To: Job Snijders <job@openbsd.org>, Jason McIntyre <jmc@kerhand.co.uk>
Cc: tech@openbsd.org
Date: Sun, 16 Jun 2024 22:36:19 +0200

Hello Job,

i think your patch would be acceptable, but frankly,
i'd prefer something more like the following.


Job Snijders wrote on Sun, Jun 16, 2024 at 06:51:09PM +0000:

> I didn't see an announcement for "Single UNIX Specification version 5"

Indeed.  I think the reason is that until about SUSv3 times (~2001),
it was still common to talk about SUS and X/Open, given that until
about that time, POSIX was a collection of various moving parts
and SUS contained more than just the sum of all those POSIX parts.

But more recently, both "SUS" and "X/Open" have fallen out of use.
The term SUS is hardly needed anymore because nowadays, the POSIX
standard includes all the parts, and X/Open already merged with OSF
to become The Open Group in 1996.

Finally, while people unfortunately defined multiple arguments for the
same standards in the past, in which case collecting related arguments
into paragraphs with relatively specific paragraph titles makes sense,
this seems no longer needed for modern standards, as long as
we refrain from adding unimportant arguments.

What do you think, is the following OK?

Yours,
  Ingo


Index: mdoc.7
===================================================================
RCS file: /cvs/src/share/man/man7/mdoc.7,v
diff -u -r1.183 mdoc.7
--- mdoc.7	20 May 2024 18:40:53 -0000	1.183
+++ mdoc.7	16 Jun 2024 20:01:05 -0000
@@ -2552,7 +2552,7 @@
 .br
 The second and last Technical Corrigendum.
 .El
-.It Single UNIX Specification version 4
+.It POSIX issues 7 and 8
 .Pp
 .Bl -tag -width "-p1003.1g-2000" -compact
 .It \-p1003.1-2008
@@ -2560,8 +2560,18 @@
 .It \-susv4
 .St -susv4
 .br
-This standard is also called
-X/Open Portability Guide version 7.
+This standard is based on C99.
+It is also called the
+Open Group Standard Base Specifications, Issue 7.
+.El
+.Pp
+.Bl -tag -width "-p1003.1g-2000" -compact
+.It \-p1003.1-2024
+.St -p1003.1-2024
+.br
+This standard is based on C17.
+It is also called the
+Open Group Standard Base Specifications, Issue 8.
 .El
 .It Other standards
 .Pp


> Index: mdoc.7
> ===================================================================
> RCS file: /cvs/src/share/man/man7/mdoc.7,v
> diff -u -p -r1.183 mdoc.7
> --- mdoc.7	20 May 2024 18:40:53 -0000	1.183
> +++ mdoc.7	16 Jun 2024 18:49:41 -0000
> @@ -2563,6 +2563,12 @@ The second and last Technical Corrigendu
>  This standard is also called
>  X/Open Portability Guide version 7.
>  .El
> +.It The Open Group Base Specifications, Issue 8
> +.Pp
> +.Bl -tag -width "-p1003.1g-2000" -compact
> +.It \-p1003.1-2024
> +.St -p1003.1-2024
> +.El
>  .It Other standards
>  .Pp
>  .Bl -tag -width "-p1003.1g-2000" -compact