[src/trunk]: src/lib/libc/gen Fix the note about errno in ERRORS; telldir(3),...

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1376cc959361
branches:  trunk
changeset: 754934:1376cc959361
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Mon May 17 03:04:09 2010 +0000

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

diffstat:

 lib/libc/gen/directory.3 |  26 +++++++++++++++++---------
 1 files changed, 17 insertions(+), 9 deletions(-)

diffs (54 lines):

diff -r a8125537bc68 -r 1376cc959361 lib/libc/gen/directory.3
--- a/lib/libc/gen/directory.3  Sun May 16 15:56:39 2010 +0000
+++ b/lib/libc/gen/directory.3  Mon May 17 03:04:09 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: directory.3,v 1.32 2010/05/16 11:37:06 wiz Exp $
+.\"    $NetBSD: directory.3,v 1.33 2010/05/17 03:04:09 jruoho Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)directory.3        8.1 (Berkeley) 6/4/93
 .\"
-.Dd May 16, 2010
+.Dd May 17, 2010
 .Dt DIRECTORY 3
 .Os
 .Sh NAME
@@ -258,13 +258,6 @@
 .Xr fchdir 2
 function.
 .El
-.Pp
-.\"
-.\" XXX: The returned errors should be enumerated.
-.\"
-All described functions that return a value may set
-.Vt errno
-to indicate the error.
 .Sh EXAMPLES
 Sample code which searches a directory for entry
 .Dq name
@@ -364,6 +357,21 @@
 However, if both the parent and child processes use these functions,
 the result is undefined.
 .El
+.Sh ERRORS
+.\"
+.\" XXX: The errors should be enumerated.
+.\"
+Upon failure, the functions
+.Fn opendir ,
+.Fn fdopendir ,
+.Fn readdir ,
+.Fn readdir_r ,
+.Fn closedir ,
+and
+.Fn dirfd
+may set
+.Vt errno
+to indicate the error.
 .Sh SEE ALSO
 .Xr close 2 ,
 .Xr lseek 2 ,