<!-- ##### FUNCTION g_strlcat ##### -->
<para>
-Portability wrapper that calls strlcat() on systems which have it, and emulates it otherwise. Appends nul-terminated @src string to @dest, guaranteeing
+Portability wrapper that calls strlcat() on systems which have it, and emulates it otherwise.
+Appends nul-terminated @src string to @dest, guaranteeing
nul-termination for @dest. The total size of @dest won't exceed
@dest_size. Caveat: this is supposedly a more secure alternative to strcat() or
strncat(), but for real security g_strconcat() is harder to mess up.
@str:
@len:
@Returns:
-<!-- # Unused Parameters # -->
-@string:
<!-- ##### FUNCTION g_ascii_tolower ##### -->
For example, <literal>g_strreverse ("abcdef")</literal> will result in "fedcba".
</para>
<para>
-Note that g_strreverse() doesn't work on UTF-8 strings containing multibyte characters. For that purpose, use g_utf8_strreverse().
+Note that g_strreverse() doesn't work on UTF-8 strings containing multibyte characters.
+For that purpose, use g_utf8_strreverse().
</para>
@string: the string to reverse.
@buf_len:
@d:
@Returns:
-<!-- # Unused Parameters # -->
-@format:
<!-- ##### FUNCTION g_ascii_formatd ##### -->
@delimiters: a string containing the current delimiters, or %NULL to use the
standard delimiters defined in #G_STR_DELIMITERS.
@new_delimiter: the new delimiter character.
-@Returns:
+@Returns: @string.
<!-- ##### MACRO G_STR_DELIMITERS ##### -->
<!-- ##### FUNCTION g_strconcat ##### -->
<para>
Concatenates all of the given strings into one long string. The returned string
-should be freed when no longer needed. WARNING: THE VARIABLE ARGUMENT LIST MUST
-END WITH %NULL. If you forget the %NULL, g_strconcat() will start appending
-random memory junk to your string.
+should be freed when no longer needed.
</para>
+<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>
+
@string1: The first string to add, which must not be %NULL.
@Varargs: a %NULL-terminated list of strings to append to the string.
@Returns: a newly-allocated string containing all the string arguments.
documentation.
@Returns: a string describing the error code.
If the error code is unknown, it returns "unknown error (<code>)".
-The string can only be used until the next call to g_strerror.
+The string can only be used until the next call to g_strerror().
<!-- ##### FUNCTION g_strsignal ##### -->
documentation.
@Returns: a string describing the signal.
If the signal is unknown, it returns "unknown signal (<signum>)".
-The string can only be used until the next call to g_strsignal.
+The string can only be used until the next call to g_strsignal().