updated g_strndup.

2000-07-01  Damon Chaplin  <damon@helixcode.com>

	* tmpl/string_utils.sgml: updated g_strndup.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index a4c80f54418e54fa0e57ec48c38ac22e8d0ded64..6f682b1bad9d7ed307c63e2128277fceb3faed5c 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2000-07-01  Damon Chaplin  <damon@helixcode.com>
+
+       * tmpl/string_utils.sgml: updated g_strndup.
+
 2000-06-11  Damon Chaplin  <damon@helixcode.com>
 
        * tmpl/messages.sgml: updated a bit more.

diff --git a/docs/reference/glib/glib/ChangeLog b/docs/reference/glib/glib/ChangeLog
index a4c80f54418e54fa0e57ec48c38ac22e8d0ded64..6f682b1bad9d7ed307c63e2128277fceb3faed5c 100644 (file)
--- a/docs/reference/glib/glib/ChangeLog
+++ b/docs/reference/glib/glib/ChangeLog
@@ -1,3 +1,7 @@
+2000-07-01  Damon Chaplin  <damon@helixcode.com>
+
+       * tmpl/string_utils.sgml: updated g_strndup.
+
 2000-06-11  Damon Chaplin  <damon@helixcode.com>
 
        * tmpl/messages.sgml: updated a bit more.

diff --git a/docs/reference/glib/tmpl/string_utils.sgml b/docs/reference/glib/tmpl/string_utils.sgml
index 2362f7782eb78ac10eebed0364b34e943058dbb2..fe8566f37c7fad05e171e98d39bc78e7986e8b0c 100644 (file)
--- a/docs/reference/glib/tmpl/string_utils.sgml
+++ b/docs/reference/glib/tmpl/string_utils.sgml
@@ -27,15 +27,15 @@ The returned string should be freed when no longer needed.
 
 <!-- ##### FUNCTION g_strndup ##### -->
 <para>
-Duplicates the first @n characters of a string, and null-terminates it.
-If @str is NULL, NULL is returned.
-The returned string should be freed when no longer needed.
+Duplicates the first @n characters of a string, returning a newly-allocated
+buffer @n + 1 characters long which will always be null-terminated.
+If @str is less than @n characters long the buffer is padded with nulls.
+The returned value should be freed when no longer needed.
 </para>
 
 @str: the string to duplicate part of.
-@n: the number of characters to copy, which must be less than or equal to the
-length of @str.
-@Returns: a newly-allocated copy of the first @n characters of @str,
+@n: the maximum number of characters to copy from @str.
+@Returns: a newly-allocated buffer containing the first @n characters of @str,
 null-terminated.