[libc-commits] [libc] [libc][docs] adds macro handling, POSIX status, and validation to docgen (PR #89421)

[via libc-commits]

enh-google wrote:

> > i think "The Open Group Base Specifications Issue 7, 2018 edition // IEEE Std 1003.1™-2017 (Revision of IEEE Std 1003.1-2008)" makes sense in the context of "POSIX.1-2017 is simultaneously IEEE Std 1003.1™-2017 and The Open Group Technical Standard Base Specifications, Issue 7"...
> 
> lol, what a mouthful. If we were to abbreviate that for the purposes of documentation, would it make more sense to say _POSIX 2017_ or _POSIX 2018_, or something else (**POSIX.1-2017**). I feel like Michael Kerrisk's book had a chapter on this...before 2017 edition though.

a grep of the man-pages git project shows that "POSIX-1.2001" (or whatever; they're usually talking about the year something was _introduced_) is their preferred format. that makes sense to me, because i think that's what folks are most used to seeing?

https://github.com/llvm/llvm-project/pull/89421