Package: manpages-dev Version: 3.44-1 Severity: normal
Dear Maintainer, The man page for the 'access' function describes two ways to use the function: to check whether the current real user ID has specific permissions for a file (R_OK, W_OK, X_OK), or to check whether that file simply exists (F_OK). The "Return Value" section of the man page, however, appears to be written exclusively in the context of the "check permissions" modes. It documents a value of zero as meaning "success (all requested permissions granted)", but does not describe the meanings of return values when checking only for existence rather than attempting to check any permissions. A usage example near the bottom of what appears to be the z/OS man page for the same function http://publib.boulder.ibm.com/infocenter/zos/v1r11/topic/com.ibm.zos.r11.bpxbd00/rtacc.htm seems to indicate that in the "check existence" mode, a return value of zero indicates that the file exists, and nonzero indicates that the file does not exist; however, even in that version of the man page, the "Returned Value" section appears to be written exclusively in the context of the "check permissions" modes. -- System Information: Debian Release: 7.0 APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 3.2.0-4-amd64 (SMP w/12 CPU cores) Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages manpages-dev depends on: ii manpages 3.44-1 manpages-dev recommends no packages. Versions of packages manpages-dev suggests: ii man-db [man-browser] 2.6.2-1 -- no debconf information -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org