This is the mail archive of the
glibc-bugs@sourceware.org
mailing list for the glibc project.
[Bug libc/4368] New: bad documentation in stdlib.h
- From: "madcoder at debian dot org" <sourceware-bugzilla at sourceware dot org>
- To: glibc-bugs at sources dot redhat dot com
- Date: 15 Apr 2007 15:44:46 -0000
- Subject: [Bug libc/4368] New: bad documentation in stdlib.h
- Reply-to: sourceware-bugzilla at sourceware dot org
in stdlib.h we read:
/* Return the canonical absolute name of file NAME. The last file name
component need not exist, and may be a symlink to a nonexistent file.
If RESOLVED is null, the result is malloc'd; otherwise, if the canonical
name is PATH_MAX chars or more, returns null with `errno' set to
ENAMETOOLONG; if the name fits in fewer than PATH_MAX chars, returns the
name in RESOLVED. */
extern char *realpath (__const char *__restrict __name,
char *__restrict __resolved) __THROW __wur;
the part about "The last file name component need not exist, and may be a
symlink to a nonexistent file" is wrong twice as:
* it does not describe how the libc performs ;
* it does not conforms to POSIX either.
I suggest this sentence to be removed from stdlib.h.
--
Summary: bad documentation in stdlib.h
Product: glibc
Version: unspecified
Status: NEW
Severity: minor
Priority: P2
Component: libc
AssignedTo: drepper at redhat dot com
ReportedBy: madcoder at debian dot org
CC: glibc-bugs at sources dot redhat dot com
http://sourceware.org/bugzilla/show_bug.cgi?id=4368
------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.