[Bug libc/4368] New: bad documentation in stdlib.h

["madcoder at debian dot org" <sourceware-bugzilla@sourceware.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.