Document that rewinddir(3) might either reopen or just lseek the dir.

(Currently it depends on the underlying directory, but documenting the
exact details seems inadvisable.)

Also, Someone(TM) should check if POSIX permits this or if we ought to
improve the implementation.

Fix some typos/malapropisms in directory(3).

Remove workaround for ancient HTML generation code.

Improved wording.

clarify closing of descriptor returned by dirfd(3)

Kill some extra spaces in function arguments.

branches: 1.37.2; 1.37.8;
Mention POSIX conformance of some functions, when they appeared, sprinkle .Xr.

Fix cross-reference, dir(5) -> dirent(3).

Fix .Xr; dirent(5) -> dirent(3).

Actually the previous is wrong; all of these can set the errno either via
each other or via something like malloc(3) or lseek(2).

Fix the note about errno in ERRORS; telldir(3), seekdir(3), and rewinddir(3)
do not set the errno.

Sort sections. Fix typo. Fix xref. Improve wording in one case.

At least one markup-typo slipped through the cracks.

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.

merge christos-time_t

New sentence, new line. Bump date for fdopendir.

Add fdopendir(), from Solaris/Linux.

branches: 1.26.28;
Explicitly mention that telldir values are only valid for the lifetime of
the DIR pointer. Pointed out by Klaus Klein.

PR/24324: Arne H Juul: Re-implement seekdir/telldir using a pointer of
locations per directory instead of a global hash table to avoid memory
leak issues, and incorrect results.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.

Drop whitespace.

Add restrict qualifiers to previous.

add mutex locking for directories and readdir_r(3). Influenced by FreeBSD.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Cosmetic changes in sample code.

New sentence, new line. From Robert Elz.

Update Dd for recent changes.

- move a example into EXAMPLES section.
- check a return value of opendir.
from openbsd.

Remove <sys/types.h> from synopsis, as per latest SUS/Posix specs.

generate & symbolically

Generate <>& symbolically.

Standardize section headers, sort sections, sort SEE ALSO, punctuation
and misc. fixes.

Boring whitespace fixes.

branches: 1.10.12;
Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

add LIBRARY section to man page

Add missing `STANDARDS' compliance statements. As we #define _POSIX_VERSION
to 199009L, bump existing statements to 1003.1-1990.

clean up Id's on files previously imported...

branches: 1.6.2;
Sync with 4.4 lite

Fix spelling errors.

Fixed typo. Readdir returns a "struct dirent *", not "struct dirent".

Technically, readdir(3) returns a `struct dirent *', not a `struct direct *',
not that they aren't the same thing.

Add RCS identifiers.

branches: 1.1.1;
Initial revision

Remove workaround for ancient HTML generation code.

Improved wording.

clarify closing of descriptor returned by dirfd(3)

Kill some extra spaces in function arguments.

branches: 1.37.2; 1.37.8;
Mention POSIX conformance of some functions, when they appeared, sprinkle .Xr.

Fix cross-reference, dir(5) -> dirent(3).

Fix .Xr; dirent(5) -> dirent(3).

Actually the previous is wrong; all of these can set the errno either via
each other or via something like malloc(3) or lseek(2).

Fix the note about errno in ERRORS; telldir(3), seekdir(3), and rewinddir(3)
do not set the errno.

Sort sections. Fix typo. Fix xref. Improve wording in one case.

At least one markup-typo slipped through the cracks.

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.

merge christos-time_t

New sentence, new line. Bump date for fdopendir.

Add fdopendir(), from Solaris/Linux.

branches: 1.26.28;
Explicitly mention that telldir values are only valid for the lifetime of
the DIR pointer. Pointed out by Klaus Klein.

PR/24324: Arne H Juul: Re-implement seekdir/telldir using a pointer of
locations per directory instead of a global hash table to avoid memory
leak issues, and incorrect results.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.

Drop whitespace.

Add restrict qualifiers to previous.

add mutex locking for directories and readdir_r(3). Influenced by FreeBSD.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Cosmetic changes in sample code.

New sentence, new line. From Robert Elz.

Update Dd for recent changes.

- move a example into EXAMPLES section.
- check a return value of opendir.
from openbsd.

Remove <sys/types.h> from synopsis, as per latest SUS/Posix specs.

generate & symbolically

Generate <>& symbolically.

Standardize section headers, sort sections, sort SEE ALSO, punctuation
and misc. fixes.

Boring whitespace fixes.

branches: 1.10.12;
Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

add LIBRARY section to man page

Add missing `STANDARDS' compliance statements. As we #define _POSIX_VERSION
to 199009L, bump existing statements to 1003.1-1990.

clean up Id's on files previously imported...

branches: 1.6.2;
Sync with 4.4 lite

Fix spelling errors.

Fixed typo. Readdir returns a "struct dirent *", not "struct dirent".

Technically, readdir(3) returns a `struct dirent *', not a `struct direct *',
not that they aren't the same thing.

Add RCS identifiers.

branches: 1.1.1;
Initial revision

Improved wording.

clarify closing of descriptor returned by dirfd(3)

Kill some extra spaces in function arguments.

branches: 1.37.2; 1.37.8;
Mention POSIX conformance of some functions, when they appeared, sprinkle .Xr.

Fix cross-reference, dir(5) -> dirent(3).

Fix .Xr; dirent(5) -> dirent(3).

Actually the previous is wrong; all of these can set the errno either via
each other or via something like malloc(3) or lseek(2).

Fix the note about errno in ERRORS; telldir(3), seekdir(3), and rewinddir(3)
do not set the errno.

Sort sections. Fix typo. Fix xref. Improve wording in one case.

At least one markup-typo slipped through the cracks.

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.

merge christos-time_t

New sentence, new line. Bump date for fdopendir.

Add fdopendir(), from Solaris/Linux.

branches: 1.26.28;
Explicitly mention that telldir values are only valid for the lifetime of
the DIR pointer. Pointed out by Klaus Klein.

PR/24324: Arne H Juul: Re-implement seekdir/telldir using a pointer of
locations per directory instead of a global hash table to avoid memory
leak issues, and incorrect results.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.

Drop whitespace.

Add restrict qualifiers to previous.

add mutex locking for directories and readdir_r(3). Influenced by FreeBSD.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Cosmetic changes in sample code.

New sentence, new line. From Robert Elz.

Update Dd for recent changes.

- move a example into EXAMPLES section.
- check a return value of opendir.
from openbsd.

Remove <sys/types.h> from synopsis, as per latest SUS/Posix specs.

generate & symbolically

Generate <>& symbolically.

Standardize section headers, sort sections, sort SEE ALSO, punctuation
and misc. fixes.

Boring whitespace fixes.

branches: 1.10.12;
Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

add LIBRARY section to man page

Add missing `STANDARDS' compliance statements. As we #define _POSIX_VERSION
to 199009L, bump existing statements to 1003.1-1990.

clean up Id's on files previously imported...

branches: 1.6.2;
Sync with 4.4 lite

Fix spelling errors.

Fixed typo. Readdir returns a "struct dirent *", not "struct dirent".

Technically, readdir(3) returns a `struct dirent *', not a `struct direct *',
not that they aren't the same thing.

Add RCS identifiers.

branches: 1.1.1;
Initial revision