[RFC] Canonical Standards Names
Rical Jasan
ricaljasan@pacific.net
Tue Jun 20 12:49:00 GMT 2017
I would like to pick back up the discussion on choosing which standard
names should be used in @standards in the manual, and be documented and
referred to (e.g., in creature.texi).
First, a recap on the discussion so far.
Early on in [1], Michael Kerrisk expressed a desire to use consistent
names between glibc and the man-pages (there is a standards(7) page).
In [2], Joseph Myers proposed an initial list, with some rationale and
correlation to feature test macros. I expanded on Joseph's list in [3],
and Zack Weinberg followed up on that with further suggestions and
rationale in [4].
The specific topic of which forms to use largely stopped there; I
apologize if I overlooked anybody else. Since then, consensus on the
use of a new custom macro, @standards, was pursued, and with that now in
place, the next step is to begin adding missing header and standard
annotations.
So, how would you like to see standards documented in the manual?
Thank you,
Rical
[1] https://sourceware.org/ml/libc-help/2016-10/msg00030.html
[2] https://sourceware.org/ml/libc-alpha/2016-11/msg00898.html
[3] https://sourceware.org/ml/libc-alpha/2016-12/msg00142.html
[4] https://sourceware.org/ml/libc-alpha/2016-12/msg00186.html
More information about the Libc-alpha
mailing list