Various fixes as per Debian bug 411177.

* s/effective/real/ in description test.
* added <fcntl.h> to synopsis.
* various other changes.

diff --git a/man2/faccessat.2 b/man2/faccessat.2
index b06d4820a005d79cbab5182ed550883ef7a13e8b..80989f442111ab078a442f65c80771f825918e60 100644 (file)
--- a/man2/faccessat.2
+++ b/man2/faccessat.2
@@ -23,12 +23,13 @@
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
 .\"
-.TH FACCESSAT 2 2006-05-05 "Linux 2.6.16" "Linux Programmer's Manual"
+.TH FACCESSAT 2 2007-02-28 "Linux 2.6.16" "Linux Programmer's Manual"
 .SH NAME
-faccessat \- change permissions of a file relative to a directory \
-file descriptor
+faccessat \- check user's permissions of a file relative to a \
+directory file descriptor
 .SH SYNOPSIS
 .nf
+.B #include <fcntl.h>
 .B #include <unistd.h>
 .sp
 .BI "int faccessat(int " dirfd ", const char *" pathname ", int " \
@@ -76,7 +77,7 @@ is constructed by ORing together zero or more of the following values:
 Perform access checks using the effective user and group IDs.  
 By default, 
 .BR faccessat ()
-uses the effective IDs (like
+uses the real IDs (like
 .BR access (2)).
 .TP
 .B AT_SYMLINK_NOFOLLOW
@@ -85,7 +86,7 @@ If
 is a symbolic link, do not dereference it: 
 instead return information about the link itself.
 .SH "RETURN VALUE"
-On success,
+On success, (all requested permissions granted)
 .BR faccessat () 
 returns 0.  
 On error, \-1 is returned and