CVS commit: src/lib/libc/gen

[Jukka Ruohonen <jruoho%netbsd.org@localhost>]

Module Name:    src
Committed By:   jruoho
Date:           Sun May 16 07:52:58 UTC 2010

Modified Files:
        src/lib/libc/gen: directory.3

Log Message:
Rewrite much of the page.

Provide much more detailed and structured discussion. Notably, try to gather
some of the conditions around the famous undefined behavior; these functions
(or the implementations) are quite prone to such behavior.

Add compatibility notes. (The big change here is that in SUSv4 it is no
longer mandated that the directory streams are implemented by using file
descriptors.)

XXX: Please proofread this. Consider also adding some additional notes. For
     instance, I left the semantics about "." and ".." out.  The returned
     errno's should be enumerated as well.


To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 src/lib/libc/gen/directory.3

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.