"Andrew Pham" <[EMAIL PROTECTED]> writes: > 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
The GNU C library (aka glibc) has it's own documentation that is in general more uptodate than Andries' man pages. Please use that documentation in preference. > > Where we found GNU upstream man pages : > (for compare and copy) Those are the LInux man pages - not the GNU man pages. > ftp://ftp.win.tue.nl/pub/linux-local/manpages/ maintained by > Andries.Brouwer <[EMAIL PROTECTED]>. > > 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. Andreas -- Andreas Jaeger SuSE Labs [EMAIL PROTECTED] private [EMAIL PROTECTED] http://www.suse.de/~aj
