Defect report from : Mark Ziegast , SHware Systems
(Please direct followup comments direct to yyyyyyyyyyyyyy@xxxxxxxxxxxxx)
@ page 0 line 1 section unistd.h editorial {020425-01}
Problem:
Defect code : 2. Omission
The Specification makes reference in unistd.h to POSIX2_C_BIND option group
designator, yet nowhere summarizes or specifies which headers, interfaces and
utilities are part of this option group, or even provides a margin notation
allowing to designate those features. While this group may no longer be
considered optional, as the header says the ident shall be defined, for
completeness sake such a summary and notation should be provided. The same lack
of completeness applies to the _POSIX2_CHAR_TERM and the UPE Group identifiers.
Per request below, addressing this would provide a succinct but complete
functionally ordered index of what comprises each of the levels of Conformance.
Right now everything is pretty much scattered over the four volumes.
Also, though this is more a nit, there's no succinct splitout of which headers
and interfaces are mandated as part of the c99 and fort77 specs, which ones
define the hosting API for those compilers, and which are there just to support
other utilities or application classes.
Action:
Ideally, having a separate page in XBD with a table listing each Option Group
Identifier and the headers, interfaces, utilities, and sub-groups affected
would be welcome... e.g.:
POSIX Mandatory
Headers: xxxx.h.html, ...
Interfaces: xxx(), ...
Utilities: ueil1, util2, ...
POSIX Options, not part of XOPEN base or Option Groups
Option_Ident1
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
Option_Ident2
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
XSI Base
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
Option Group1 promoted to mandatory
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
Option Group2 promoted to mandatory
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
XSI Option Group1
POSIX Option1
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
POSIX Options2
Headers: xxxx.h.html, ...
Interfaces: xxx().html, ...
Utilities: util1.html, ...
etc.
If a referenced page is affected by more than one identifier, that reference
should be duplicated, perhaps excepting unistd.h as it's part of all groups.
The Margin Codes summary pop-up could also be extended to link back to the
appropriate section of this summary page.
|