Re: Order of look-up for included interfaces
"Andrew Pham" <andpha@us.ibm.com> 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 <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.
Andreas
--
Andreas Jaeger
SuSE Labs aj@suse.de
private aj@arthur.inka.de
http://www.suse.de/~aj
Reply to: