Teach mandoc about IEEE Std 1003.1-2008, 2017 Edition ("POSIX.1")

[0mp]

Summary

Teach mandoc about IEEE Std 1003.1-2008, 2017 Edition ("POSIX.1")

There is a macro in the mdoc(7) language to specify various standards in manual
pages. For example:

    .St -p1003.2

would render as

    IEEE Std 1003.2 ("POSIX.2")

Unfortunately, mandoc upstream has not added an appropriate abbreviation for
IEEE Std 1003.1-2008, 2017 Edition ("POSIX.1").

This commit adds this abbreviation so that we can use it in our manual pages.

[0mp]

A similar revision from the past: D13349

[bapt]

have you upstreamed that first?

[0mp]

In D23944#526235, @bapt wrote:

have you upstreamed that first?

No, not yet.

[bapt]

this should be upstreamed first then committed to the source tree as validated upstream.
I will probably in this case just update the snapshot of mandoc we are using.

[0mp]

In D23944#526283, @bapt wrote:

this should be upstreamed first then committed to the source tree as validated upstream.
I will probably in this case just update the snapshot of mandoc we are using.

OK! Let's do it this way.

[ziaee]

I've been working with upstream in preparation for mandoc 1.15. They are saying no new standard abbreviation macros, they cause portability problems and it is just fine to type out the text. I'm planning to revert the unique ones we have to increase portability, such as fixing rendering on man.freebsd.org which uses groff. Will you close this to clean up the queue?

[imp]

In D23944#1383089, @ziaee wrote:

I've been working with upstream in preparation for mandoc 1.15. They are saying no new standard abbreviation macros, they cause portability problems and it is just fine to type out the text. I'm planning to revert the unique ones we have to increase portability, such as fixing rendering on man.freebsd.org which uses groff. Will you close this to clean up the queue?

The proffered reasons when I asked was that 2008 is the last standard (the 2013, 2016 and 2017 editions were just corrections), so they wouldn't be added and one should use just the 2008 edition.

I hadn't heard the no-new-standards thing though... But this was a couple of years ago.... And this is just a btw, not advocating for anything.