accept.2, copy_file_range.2, eventfd.2, inotify_init.2, pipe.2, readahead.2, signalfd.2, socket.2, timerfd_create.2: Clarify the distinction between "file descriptor" and "file description"

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

man2/accept.2

@@ -151,7 +151,9 @@ to obtain different behavior:
 .B SOCK_NONBLOCK
 Set the
 .BR O_NONBLOCK
-file status flag on the new open file description.
+file status flag on the open file description (see
+.BR open (2))
+referred to by the new file descriptor.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.

man2/copy_file_range.2

@@ -100,7 +100,9 @@ is not open for reading; or
 is not open for writing; or
 the
 .B O_APPEND
-flag is set for the open file description referred to by
+flag is set for the open file description (see
+.BR open (2))
+referred to by the file descriptor
 .IR fd_out .
 .TP
 .B EFBIG

man2/eventfd.2

@@ -60,7 +60,9 @@ for reasons why this may be useful.
 .BR EFD_NONBLOCK " (since Linux 2.6.27)"
 Set the
 .BR O_NONBLOCK
-file status flag on the new open file description.
+file status flag on the open file description (see
+.BR open (2))
+referred to by the new file descriptor.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.

man2/inotify_init.2

@@ -57,7 +57,9 @@ to obtain different behavior:
 .B IN_NONBLOCK
 Set the
 .BR O_NONBLOCK
-file status flag on the new open file description.
+file status flag on the open file description (see
+.BR open (2))
+referred to by the new file descriptor.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.

man2/pipe.2

@@ -134,7 +134,8 @@ setting of a pipe file descriptor using
 .B O_NONBLOCK
 Set the
 .BR O_NONBLOCK
-file status flag on the two new open file descriptions.
+file status flag on the open file descriptions
+referred to by the new file descriptors.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.

man2/readahead.2

@@ -60,7 +60,7 @@ equal to
 .IR "(offset+count)" .
 .BR readahead ()
 does not read beyond the end of the file.
-The file offset of the open file description referred to by
+The file offset of the open file description referred to by the file descriptor
 .I fd
 is left unchanged.
 .SH RETURN VALUE

man2/signalfd.2

@@ -78,7 +78,9 @@ to change the behavior of
 .B SFD_NONBLOCK
 Set the
 .BR O_NONBLOCK
-file status flag on the new open file description.
+file status flag on the open file description (see
+.BR open (2))
+referred to by the new file descriptor.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.

man2/socket.2

@@ -258,7 +258,9 @@ to modify the behavior of
 .B SOCK_NONBLOCK
 Set the
 .BR O_NONBLOCK
-file status flag on the new open file description.
+file status flag on the open file description (see
+.BR open (2))
+referred to by the new file descriptor.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.

man2/timerfd_create.2

@@ -120,7 +120,9 @@ to change the behavior of
 .B TFD_NONBLOCK
 Set the
 .BR O_NONBLOCK
-file status flag on the new open file description.
+file status flag on the open file description (see
+.BR open (2))
+referred to by the new file descriptor.
 Using this flag saves extra calls to
 .BR fcntl (2)
 to achieve the same result.