fanotify_init.2: Minor wording fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/fanotify_init.2 b/man2/fanotify_init.2
index 01a8478ad60424da9e0af6f81e793cbf4a9fffad..2cb288720fb80287ec234bffad30df8efeeed806 100644 (file)
--- a/man2/fanotify_init.2
+++ b/man2/fanotify_init.2
@@ -106,13 +106,14 @@ order
 .BR FAN_CLASS_PRE_CONTENT ,
 .BR FAN_CLASS_CONTENT ,
 .BR FAN_CLASS_NOTIF .
-The order of notification for listeners of the same value is undefined.
+The order of notification for listeners in the same notification class
+is undefined.
 .PP
-The following bit mask values can be set additionally in
+The following bits can additionally be set in
 .IR flags :
 .TP
 .B FAN_CLOEXEC
-This flag sets the close-on-exec flag
+Set the close-on-exec flag
 .RB ( FD_CLOEXEC )
 on the new file descriptor.
 See the description of the
@@ -121,7 +122,7 @@ flag in
 .BR open (2).
 .TP
 .B FAN_NONBLOCK
-This flag enables the nonblocking flag
+Enable the nonblocking flag
 .RB ( O_NONBLOCK )
 for the file descriptor.
 Reading from the file descriptor will not block.
@@ -131,26 +132,26 @@ will fail with the error
 .BR EAGAIN .
 .TP
 .B FAN_UNLIMITED_QUEUE
-This flag removes the limit of 16384 events for the event queue.
-It requires the
+Remove the limit of 16384 events for the event queue.
+Use of this flag requires the
 .B CAP_SYS_ADMIN
 capability.
 .TP
 .B FAN_UNLIMITED_MARKS
-This flag removes the limit of 8192 marks.
-It requires the
+Remove the limit of 8192 marks.
+Use of this flag requires the
 .B CAP_SYS_ADMIN
 capability.
 .PP
-The argument
+The
 .I event_f_flags
-defines the file flags with which file descriptors for fanotify events
-shall be created.
-For explanations of possible values, see the argument
+argument
+defines the file status flags that will be set on the open file descriptions
+that are created for fanotify events.
+For details of these flags, see the description of the
 .I flags
-of the
-.BR open (2)
-system call.
+values in
+.BR open (2).
 Useful values are:
 .TP
 .B O_RDONLY
@@ -163,10 +164,10 @@ This value allows only write access.
 This value allows read and write access.
 .TP
 .B O_CLOEXEC
-This flag enables the close-on-exec flag for the file descriptor.
+Enable the close-on-exec flag for the file descriptor.
 .TP
 .B O_LARGEFILE
-This flag enables support for files exceeding 2 GB.
+Enable support for files exceeding 2 GB.
 Failing to set this flag will result in an
 .B EOVERFLOW
 error when trying to open a large file which is monitored by
@@ -187,7 +188,7 @@ An invalid value was passed in
 defines all allowable bits.
 .TP
 .B EMFILE
-The number of fanotify groups of the user exceeds 128.
+The number of fanotify groups for this user exceeds 128.
 .TP
 .B ENOMEM
 The allocation of memory for the notification group failed.
@@ -195,9 +196,8 @@ The allocation of memory for the notification group failed.
 .B ENOSYS
 This kernel does not implement
 .BR fanotify_init ().
-To make the fanotify API available,
-.B CONFIG_FANOTIFY
-has to be enabled in the Linux configuration.
+The fanotify API is available only if the kernel was configured with
+.BR CONFIG_FANOTIFY .
 .TP
 .B EPERM
 The operation is not permitted because the caller lacks the