about summary refs log tree commit diff
diff options
context:
space:
mode:
authorFabrice Bauzac <fabrice.bauzac@wanadoo.fr>2012-02-17 23:34:01 +0000
committerJoseph Myers <joseph@codesourcery.com>2012-02-17 23:34:01 +0000
commit0520adde6b06d750067cbdf46b1fb9d098b33a95 (patch)
tree2d796cabf05c25f66bffe820e243106e9b9c488b
parent3f4081cd59f0a69b74d5361de57a8225b26363e2 (diff)
downloadglibc-0520adde6b06d750067cbdf46b1fb9d098b33a95.tar.gz
glibc-0520adde6b06d750067cbdf46b1fb9d098b33a95.tar.xz
glibc-0520adde6b06d750067cbdf46b1fb9d098b33a95.zip
Change recommendation of strchrnul in strchr documentation.
-rw-r--r--ChangeLog6
-rw-r--r--NEWS6
-rw-r--r--manual/string.texi9
3 files changed, 15 insertions, 6 deletions
diff --git a/ChangeLog b/ChangeLog
index 38c8ed96db..6a9b16b02a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2012-02-17  Fabrice Bauzac  <fabrice.bauzac@wanadoo.fr>
+
+	[BZ #6907]
+	* manual/string.texi (strchr): Change when strchrnul is
+	recommended.
+
 2012-02-17  Dwayne Grant McConnell  <decimal@us.ibm.com>
 
 	[BZ #174]
diff --git a/NEWS b/NEWS
index c25d34343c..59e07eaabf 100644
--- a/NEWS
+++ b/NEWS
@@ -9,9 +9,9 @@ Version 2.16
 
 * The following bugs are resolved with this release:
 
-  174, 350, 411, 3335, 4026, 4822, 5805, 6884, 9902, 10140, 10210, 11494,
-  12047, 13525, 13526, 13527, 13528, 13529, 13530, 13531, 13532, 13533,
-  13547, 13551, 13552, 13553, 13555, 13559, 13583, 13618
+  174, 350, 411, 3335, 4026, 4822, 5805, 6884, 6907, 9902, 10140, 10210,
+  11494, 12047, 13525, 13526, 13527, 13528, 13529, 13530, 13531, 13532,
+  13533, 13547, 13551, 13552, 13553, 13555, 13559, 13583, 13618
 
 * ISO C11 support:
 
diff --git a/manual/string.texi b/manual/string.texi
index f7d4ebea1d..abfb0798b9 100644
--- a/manual/string.texi
+++ b/manual/string.texi
@@ -1647,9 +1647,12 @@ strchr ("hello, world", '?')
 
 The terminating null character is considered to be part of the string,
 so you can use this function get a pointer to the end of a string by
-specifying a null character as the value of the @var{c} argument.  It
-would be better (but less portable) to use @code{strchrnul} in this
-case, though.
+specifying a null character as the value of the @var{c} argument.
+
+When @code{strchr} returns a null pointer, it does not let you know
+the position of the terminating null character it has found.  If you
+need that information, it is better (but less portable) to use
+@code{strchrnul} than to search for it a second time.
 @end deftypefun
 
 @comment wchar.h