From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 17385 invoked by alias); 15 Apr 2007 15:44:58 -0000 Received: (qmail 17362 invoked by uid 48); 15 Apr 2007 15:44:46 -0000 Date: Sun, 15 Apr 2007 15:44:00 -0000 From: "madcoder at debian dot org" To: glibc-bugs@sources.redhat.com Message-ID: <20070415164444.4368.madcoder@debian.org> Reply-To: sourceware-bugzilla@sourceware.org Subject: [Bug libc/4368] New: bad documentation in stdlib.h X-Bugzilla-Reason: CC Mailing-List: contact glibc-bugs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: glibc-bugs-owner@sourceware.org X-SW-Source: 2007-04/txt/msg00060.txt.bz2 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.