Better describe open arguments

	[BZ #6649]
	* manual/llio.texi (Opening and Closing Files): Add cross
	reference to explain mode argument.

diff --git a/ChangeLog b/ChangeLog
index 91e8361..1d6f69f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2012-04-08  Stephen Compall  <s11@member.fsf.org>
+
+       [BZ #6649]
+       * manual/llio.texi (Opening and Closing Files): Add cross
+       reference to explain mode argument.
+

 2012-04-06  H.J. Lu  <hongjiu.lu@intel.com>
 
        * bits/byteswap.h (__bswap_16): Removed.
 2012-04-06  H.J. Lu  <hongjiu.lu@intel.com>
 
        * bits/byteswap.h (__bswap_16): Removed.

diff --git a/NEWS b/NEWS
index 68ed918..cec1914 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -11,15 +11,15 @@ Version 2.16
 
   174, 350, 369, 411, 2541, 2547, 2548, 2551, 2552, 2553, 2554, 2562, 2563,
   2565, 2566, 2576, 2678, 3335, 3866, 3868, 3976, 3992, 4026, 4108, 4596,
 
   174, 350, 369, 411, 2541, 2547, 2548, 2551, 2552, 2553, 2554, 2562, 2563,
   2565, 2566, 2576, 2678, 3335, 3866, 3868, 3976, 3992, 4026, 4108, 4596,

-  4822, 5077, 5461, 5805, 5993, 6471, 6486, 6730, 6770, 6884, 6907, 6911,
-  9739, 9902, 10110, 10135, 10140, 10210, 10346, 10545, 10716, 11174, 11322,
-  11365, 11451, 11494, 12047, 12340, 13058, 13525, 13526, 13527, 13528,
-  13529, 13530, 13531, 13532, 13533, 13547, 13551, 13552, 13553, 13555,
-  13559, 13566, 13583, 13592, 13618, 13637, 13656, 13658, 13673, 13691,
-  13695, 13704, 13706, 13726, 13738, 13760, 13761, 13786, 13792, 13806,
-  13824, 13840, 13841, 13844, 13846, 13851, 13852, 13854, 13871, 13879,
-  13883, 13892, 13895, 13908, 13910, 13911, 13912, 13913, 13915, 13916,
-  13917, 13918, 13919, 13920, 13921, 13926, 13928, 13938
+  4822, 5077, 5461, 5805, 5993, 6471, 6486, 6649, 6730, 6770, 6884, 6907,
+  6911, 9739, 9902, 10110, 10135, 10140, 10210, 10346, 10545, 10716, 11174,
+  11322, 11365, 11451, 11494, 12047, 12340, 13058, 13525, 13526, 13527,
+  13528, 13529, 13530, 13531, 13532, 13533, 13547, 13551, 13552, 13553,
+  13555, 13559, 13566, 13583, 13592, 13618, 13637, 13656, 13658, 13673,
+  13691, 13695, 13704, 13706, 13726, 13738, 13760, 13761, 13786, 13792,
+  13806, 13824, 13840, 13841, 13844, 13846, 13851, 13852, 13854, 13871,
+  13879, 13883, 13892, 13895, 13908, 13910, 13911, 13912, 13913, 13915,
+  13916, 13917, 13918, 13919, 13920, 13921, 13926, 13928, 13938

 
 * ISO C11 support:
 
 
 * ISO C11 support:
 

diff --git a/manual/llio.texi b/manual/llio.texi
index 1da612a..acafed3 100644 (file)
--- a/manual/llio.texi
+++ b/manual/llio.texi
@@ -78,11 +78,11 @@ declared in @file{unistd.h}.
 @comment fcntl.h
 @comment POSIX.1
 @deftypefun int open (const char *@var{filename}, int @var{flags}[, mode_t @var{mode}])
 @comment fcntl.h
 @comment POSIX.1
 @deftypefun int open (const char *@var{filename}, int @var{flags}[, mode_t @var{mode}])

-The @code{open} function creates and returns a new file descriptor
-for the file named by @var{filename}.  Initially, the file position
+The @code{open} function creates and returns a new file descriptor for
+the file named by @var{filename}.  Initially, the file position

 indicator for the file is at the beginning of the file.  The argument
 indicator for the file is at the beginning of the file.  The argument

-@var{mode} is used only when a file is created, but it doesn't hurt
-to supply the argument in any case.
+@var{mode} (@pxref{Permission Bits}) is used only when a file is
+created, but it doesn't hurt to supply the argument in any case.

 
 The @var{flags} argument controls how the file is to be opened.  This is
 a bit mask; you create the value by the bitwise OR of the appropriate
 
 The @var{flags} argument controls how the file is to be opened.  This is
 a bit mask; you create the value by the bitwise OR of the appropriate