Order of look-up for included interfaces
Hello All,
Since we received different pointers as to which standard to take as the
base reference, at different stages of our
'documenting-included-interfaces' endeavor ; we would like to post the
exact order in which we look up stuffs. First, to make sure that we are
going down the right path; and second, so that anyone who has any other
suggestion/feedback; please lets us know.
ORDER OF PRECIDENCE and LOOK-UP for a BASE-REFERENCE :
( for reference and compare)
1) ISO-C99 (pay preview)
2)SUSv3 www.opengroup.org/austin/
3)SUSv2 http://www.opengroup.org/onlinepubs/7908799/xshix.html
4)SUS-XSH -XCU -XBD -XCURSES -XNS
http://www.opengroup.org/onlinepubs/7908799/xnsix.html
Where we found GNU upstream man pages :
(for compare and copy)
ftp://ftp.win.tue.nl/pub/linux-local/manpages/ maintained by
Andries.Brouwer <Andries.Brouwer@cwi.nl>.
Where we found 4.4BSD-lite man pages :
(for copy only)
http://www.BSDI.COM/bsdi-man
***************************************************************************************************************************************************
How do we come up with a man page for an interface in LSB:
1)if an interface is found in a base-reference and in GNU:
-compare and state the differences between the two.
- if there are no differences; then no manpage is necessary, just
refer to the base reference.
2)if an interface is found in a base-reference and not in GNU:
-No manpage is necessary; only refer it to the base reference.
3)if an interface is only found in GNU:
-Just cut and paste; also we include copyright info as comment in
the source file
4)if an interface is only found in 4.4BSD-lite:
-Just cut and paste; also we include copyright info as comment in
the source file
Hopefully stuffs above make sense. As always any suggestion/feedback is
welcome and appreciated.
Regards,
Andy
Andrew H. Pham
andpha@us.ibm.com
IBM Linux Technology Center
Voice: (512)838-9473 T/L 678-9473
Reply to: