Page MenuHomeFreeBSD

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

Authored by 0mp on Mar 3 2020, 3:51 PM.
Tags
None
Referenced Files
F174664067: D23944.id.diff
Mon, Oct 5, 1:22 AM
F174653139: D23944.id69127.diff
Sun, Oct 4, 11:41 PM
F174589220: D23944.id69127.diff
Sun, Oct 4, 11:40 AM
Unknown Object (File)
Sun, Oct 4, 5:36 AM
Unknown Object (File)
Sat, Oct 3, 1:03 PM
Unknown Object (File)
Thu, Oct 1, 4:06 AM
Unknown Object (File)
Tue, Sep 29, 7:10 PM
Unknown Object (File)
Tue, Sep 29, 4:52 PM
Subscribers

Details

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.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
No Lint Coverage
Unit
No Test Coverage
Build Status
Buildable 29760
Build 27598: arc lint + arc unit

Event Timeline

A similar revision from the past: D13349

have you upstreamed that first?

In D23944#526235, @bapt wrote:

have you upstreamed that first?

No, not yet.

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 planned changes to this revision.Mar 4 2020, 10:47 PM
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 requested changes to this revision.Sat, Oct 3, 5:42 AM

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?