X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=mono%2Futils%2Fstrenc.c;h=c37bb3d20168ffb6c93473b33ce7558b4da2ffb7;hb=a097b5471761180c4aae2dab224ed9caeeae3e86;hp=24329dc4b2e4cf47205ac4c146e5f1b2fe939370;hpb=c4aef31eeea309e6a795c84c098ac8e1a2490340;p=mono.git

diff --git a/mono/utils/strenc.c b/mono/utils/strenc.c
index 24329dc4b2e..c37bb3d2016 100644
--- a/mono/utils/strenc.c
+++ b/mono/utils/strenc.c
@@ -15,7 +15,12 @@
 
 #undef DEBUG
 
-/* Tries to turn a NULL-terminated string into UTF16.
+/**
+ * mono_unicode_from_external:
+ * @in: pointers to the buffer.
+ * @bytes: number of bytes in the string.
+ *
+ * Tries to turn a NULL-terminated string into UTF16.
  *
  * First, see if it's valid UTF8, in which case just turn it directly
  * into UTF16.  Next, run through the colon-separated encodings in
@@ -26,7 +31,8 @@
  * Callers must free the returned string if not NULL. bytes holds the number
  * of bytes in the returned string, not including the terminator.
  */
-gunichar2 *mono_unicode_from_external (const gchar *in, gsize *bytes)
+gunichar2 *
+mono_unicode_from_external (const gchar *in, gsize *bytes)
 {
 	gchar *res=NULL;
 	gchar **encodings;
@@ -86,7 +92,11 @@ gunichar2 *mono_unicode_from_external (const gchar *in, gsize *bytes)
 	return(NULL);
 }
 
-/* Tries to turn a NULL-terminated string into UTF8.
+/**
+ * mono_utf8_from_external:
+ * @in: pointer to the string buffer.
+ *
+ * Tries to turn a NULL-terminated string into UTF8.
  *
  * First, see if it's valid UTF8, in which case there's nothing more
  * to be done.  Next, run through the colon-separated encodings in
@@ -150,7 +160,11 @@ gchar *mono_utf8_from_external (const gchar *in)
 	return(NULL);
 }
 
-/* Turns NULL-terminated UTF16 into either UTF8, or the first
+/**
+ * mono_unicode_to_external:
+ * @uni: an UTF16 string to conver to an external representation.
+ *
+ * Turns NULL-terminated UTF16 into either UTF8, or the first
  * working item in MONO_EXTERNAL_ENCODINGS if set.  If no conversions
  * work, then UTF8 is returned.
  *