[glib] Add a note about l10n to the g_strconcat docs

[Matthias Clasen <matthiasc src gnome org>]

commit 7cfa23b17785218463274854753494b5e49584c8
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Jul 8 19:03:18 2010 -0400

    Add a note about l10n to the g_strconcat docs
    
    As requested in bug 576854

 glib/gstrfuncs.c |    7 +++++--
 1 files changed, 5 insertions(+), 2 deletions(-)
---
diff --git a/glib/gstrfuncs.c b/glib/gstrfuncs.c
index be44eb7..67f1947 100644
--- a/glib/gstrfuncs.c
+++ b/glib/gstrfuncs.c
@@ -276,12 +276,15 @@ g_strdup_printf (const gchar *format,
  * g_strconcat:
  * @string1: the first string to add, which must not be %NULL
  * @Varargs: a %NULL-terminated list of strings to append to the string
- * 
+ *
  * Concatenates all of the given strings into one long string.
  * The returned string should be freed with g_free() when no longer needed.
  *
+ * Note that this function is usually not the right function to use to
+ * assemble a translated message from pieces, since proper translation
+ * often requires the pieces to be reordered.
  *
- * <warning><para>The variable argument list <emphasis>must</emphasis> end 
+ * <warning><para>The variable argument list <emphasis>must</emphasis> end
  * with %NULL. If you forget the %NULL, g_strconcat() will start appending
  * random memory junk to your string.</para></warning>
  *