From aa8150599d937fff816c87f3ddbf6026e81a9a6a Mon Sep 17 00:00:00 2001
From: Benjamin Otte <otte@src.gnome.org>
Date: Wed, 24 Jan 2007 16:23:23 +0000
Subject: [PATCH] Clarify the documentation + regarding overflows (wording by
 Jan Schmidt)

* glib/gprintf.c (g_sprintf): Clarify the documentation
+       regarding overflows (wording by Jan Schmidt)

svn path=/trunk/; revision=5315
---
 ChangeLog      | 5 +++++
 glib/gprintf.c | 4 +++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 1e0d45127..87b0b1ac5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-01-24  Benjamin Otte <otte@gnome.org>
+
+	* glib/gprintf.c (g_sprintf): Clarify the documentation
+	regarding overflows (wording by Jan Schmidt)
+
 2007-01-23  Roozbeh Pournader  <roozbeh@farsiweb.info>
 
 	* README: Remove mention of no-longer-existing PATCH
diff --git a/glib/gprintf.c b/glib/gprintf.c
index e62e34c3f..7de0953a2 100644
--- a/glib/gprintf.c
+++ b/glib/gprintf.c
@@ -89,7 +89,9 @@ g_fprintf (FILE        *file,
 
 /**
  * g_sprintf:
- * @string: the buffer to hold the output.
+ * @string: A pointer to a memory buffer to contain the resulting string. It 
+ *          is up to the caller to ensure that the allocated buffer is large 
+ *          enough to hold the formatted result
  * @format: a standard printf() format string, but notice 
  *          <link linkend="string-precision">string precision pitfalls</link>.
  * @Varargs: the arguments to insert in the output.