Re: Add few posix references

Re: Add few posix references

[Steffen Nurpmeso]

Baptiste Daroussin <bapt@FreeBSD.org> wrote:
 |On Wed, Dec 06, 2017 at 11:11:43AM +0100, Baptiste Daroussin wrote:
 |> Hi,
 |> 
 |> There was 2 extra edition of POSIX 2008: one in 2013 and one in 2016
 |> 
 |> Some manpages refers to them (for example freebsd's rm(1)),
 |> 
 |> here is a patch to add them
 |> 
 |> Best regards,
 |> Bapt
 |
 |Even better with the right patch

Anthony J. Bentley brought this up in the past already.  I then
have added 

+.ds doc-str-St--p1003.1-2013   \*[doc-Tn-font-size]\%IEEE\*[doc-str-St] Std 1003.1-2008/Cor 1-2013
+.as doc-str-St--p1003.1-2013   " (\*[Lq]\)\*[Px]\*[doc-str-St].1\*[Rq])
+.ds doc-str-St--p1003.1-2016   \*[doc-Tn-font-size]\%IEEE\*[doc-str-St] Std 1003.1-2008/Cor 2-2016
+.as doc-str-St--p1003.1-2016   " (\*[Lq]\)\*[Px]\*[doc-str-St].1\*[Rq])

to my future thing and gave him credit for that.  I think the real
name should be used instead of what you did given that the ISO
C entries etc. also go for the real names.
Just my one cent.

--steffen
|
|Der Kragenbaer,                The moon bear,
|der holt sich munter           he cheerfully and one by one
|einen nach dem anderen runter  wa.ks himself off
|(By Robert Gernhardt)
--
 To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv

Add few posix references

[Baptiste Daroussin]

[-- Attachment #1.1: Type: text/plain, Size: 184 bytes --]

Hi,

There was 2 extra edition of POSIX 2008: one in 2013 and one in 2016

Some manpages refers to them (for example freebsd's rm(1)),

here is a patch to add them

Best regards,
Bapt

[-- Attachment #1.2: st.in.diff --]
[-- Type: text/x-diff, Size: 801 bytes --]

Index: st.in
===================================================================
RCS file: /cvs/mandoc/st.in,v
retrieving revision 1.29
diff -u -r1.29 st.in
--- st.in	24 Jun 2017 13:49:29 -0000	1.29
+++ st.in	6 Dec 2017 10:08:21 -0000
@@ -34,6 +34,8 @@
 LINE("-p1003.1-2001",	"IEEE Std 1003.1-2001 (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1-2004",	"IEEE Std 1003.1-2004 (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1-2008",	"IEEE Std 1003.1-2008 (\\(LqPOSIX.1\\(Rq)")
+LINE("-p1003.1-2013",	"IEEE Std 1003.1-2008, 2013 Edition (\\(LqPOSIX.1\\(Rq)")
+LINE("-p1003.1-2016",	"IEEE Std 1003.1-2008, 2016 Edition (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1",	"IEEE Std 1003.1 (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1b",	"IEEE Std 1003.1b (\\(LqPOSIX.1b\\(Rq)")
 LINE("-p1003.1b-93",	"IEEE Std 1003.1b-1993 (\\(LqPOSIX.1b\\(Rq)")

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Add few posix references

[Baptiste Daroussin]

[-- Attachment #1.1: Type: text/plain, Size: 327 bytes --]

On Wed, Dec 06, 2017 at 11:11:43AM +0100, Baptiste Daroussin wrote:
> Hi,
> 
> There was 2 extra edition of POSIX 2008: one in 2013 and one in 2016
> 
> Some manpages refers to them (for example freebsd's rm(1)),
> 
> here is a patch to add them
> 
> Best regards,
> Bapt

Even better with the right patch

Bapt

[-- Attachment #1.2: st.in.diff --]
[-- Type: text/x-diff, Size: 1429 bytes --]

? ChangeLog
? st.in.diff
Index: mdoc.7
===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.270
diff -u -r1.270 mdoc.7
--- mdoc.7	23 Oct 2017 13:54:41 -0000	1.270
+++ mdoc.7	6 Dec 2017 10:14:20 -0000
@@ -2599,6 +2599,16 @@
 .br
 This standard is also called
 X/Open Portability Guide version 7.
+.Pp
+.It \-p1003.1-2013
+.St -p1003.1-2013
+The 2013 edition incorporates Technical Corrigendum 1.
+.Pp
+.It \-p1003.1-2016
+.St -p1003.1-2016
+.br
+The 2016 edition incorporates Technical Corrigendum 1 and
+Technical Corrigendum 2.
 .El
 .It Other standards
 .Pp
Index: st.in
===================================================================
RCS file: /cvs/mandoc/st.in,v
retrieving revision 1.29
diff -u -r1.29 st.in
--- st.in	24 Jun 2017 13:49:29 -0000	1.29
+++ st.in	6 Dec 2017 10:14:20 -0000
@@ -34,6 +34,8 @@
 LINE("-p1003.1-2001",	"IEEE Std 1003.1-2001 (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1-2004",	"IEEE Std 1003.1-2004 (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1-2008",	"IEEE Std 1003.1-2008 (\\(LqPOSIX.1\\(Rq)")
+LINE("-p1003.1-2013",	"IEEE Std 1003.1-2008, 2013 Edition (\\(LqPOSIX.1\\(Rq)")
+LINE("-p1003.1-2016",	"IEEE Std 1003.1-2008, 2016 Edition (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1",	"IEEE Std 1003.1 (\\(LqPOSIX.1\\(Rq)")
 LINE("-p1003.1b",	"IEEE Std 1003.1b (\\(LqPOSIX.1b\\(Rq)")
 LINE("-p1003.1b-93",	"IEEE Std 1003.1b-1993 (\\(LqPOSIX.1b\\(Rq)")

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Add few posix references

[Ingo Schwarze]

Hi Baptiste,

On Wed, Dec 06, 2017 at 11:11:43AM +0100, Baptiste Daroussin wrote:

> There was 2 extra edition of POSIX 2008: one in 2013 and one in 2016

I strongly disagree.  These are not new editions.  They are merely
technical corrigenda that almost exclusively fix trivial typos and
subtle wording details that are beyond the scope of manual pages
in the first place.  We have found practically nothing related to
them that is worth mentioning in any manual page.

> Some manpages refers to them (for example freebsd's rm(1)),

The STANDARDS section in FreeBSD rm(1) is totally broken.
If you really want to reference TC1, then you have to say

  .St -p1003.1-2008

and then specifically explain in which respect TC1 makes a difference,
because that would be such a rare exception that merely referring
to TC1 without giving any details does not help the user at all.

> here is a patch to add them

No.  Please remove these from your tree: the macros, their
documentation, and all use cases.  Even if you find a handful of
cases where explaining something related to TC1 or TC2 is useful,
just talk about TC1 and TC2 in plain English.  No macros are needed
for something that appears only a handful of times in a huge tree.

It is among the important design goals of mandoc to prevent further
proliferation of low-utility syntax.

Yours,
  Ingo


> Index: mdoc.7
> ===================================================================
> RCS file: /cvs/mandoc/mdoc.7,v
> retrieving revision 1.270
> diff -u -r1.270 mdoc.7
> --- mdoc.7	23 Oct 2017 13:54:41 -0000	1.270
> +++ mdoc.7	6 Dec 2017 10:14:20 -0000
> @@ -2599,6 +2599,16 @@
>  .br
>  This standard is also called
>  X/Open Portability Guide version 7.
> +.Pp
> +.It \-p1003.1-2013
> +.St -p1003.1-2013
> +The 2013 edition incorporates Technical Corrigendum 1.
> +.Pp
> +.It \-p1003.1-2016
> +.St -p1003.1-2016
> +.br
> +The 2016 edition incorporates Technical Corrigendum 1 and
> +Technical Corrigendum 2.
>  .El
>  .It Other standards
>  .Pp
> Index: st.in
> ===================================================================
> RCS file: /cvs/mandoc/st.in,v
> retrieving revision 1.29
> diff -u -r1.29 st.in
> --- st.in	24 Jun 2017 13:49:29 -0000	1.29
> +++ st.in	6 Dec 2017 10:14:20 -0000
> @@ -34,6 +34,8 @@
>  LINE("-p1003.1-2001",	"IEEE Std 1003.1-2001 (\\(LqPOSIX.1\\(Rq)")
>  LINE("-p1003.1-2004",	"IEEE Std 1003.1-2004 (\\(LqPOSIX.1\\(Rq)")
>  LINE("-p1003.1-2008",	"IEEE Std 1003.1-2008 (\\(LqPOSIX.1\\(Rq)")
> +LINE("-p1003.1-2013",	"IEEE Std 1003.1-2008, 2013 Edition (\\(LqPOSIX.1\\(Rq)")
> +LINE("-p1003.1-2016",	"IEEE Std 1003.1-2008, 2016 Edition (\\(LqPOSIX.1\\(Rq)")
>  LINE("-p1003.1",	"IEEE Std 1003.1 (\\(LqPOSIX.1\\(Rq)")
>  LINE("-p1003.1b",	"IEEE Std 1003.1b (\\(LqPOSIX.1b\\(Rq)")
>  LINE("-p1003.1b-93",	"IEEE Std 1003.1b-1993 (\\(LqPOSIX.1b\\(Rq)")
--
 To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv