Doxygen janitor

(This used to be commit 367997562998adb3f80602596c770d9ac319065b)

diff --git a/source3/lib/util_unistr.c b/source3/lib/util_unistr.c
index 5c9b4c783be35bbb705a17aa1bcfff01f3104a78..522ab7eb40d98662b658c9f947e5a0a405f2d2a6 100644 (file)
--- a/source3/lib/util_unistr.c
+++ b/source3/lib/util_unistr.c
@@ -95,9 +95,14 @@ static int check_dos_char(smb_ucs2_t c)
        return (c == c2);
 }
 
-/*******************************************************************
-load the valid character map table
-********************************************************************/
+/**
+ * Load the valid character map table from <tt>valid.dat</tt> or
+ * create from the configured codepage.
+ *
+ * This function is called whenever the configuration is reloaded.
+ * However, the valid character table is not changed if it's loaded
+ * from a file, because we can't unmap files.
+ **/
 void init_valid_table(void)
 {
        static int initialised;
@@ -114,6 +119,7 @@ void init_valid_table(void)
                return;
        }
 
+       /* Otherwise, using a dynamically loaded one. */
        if (valid_table) free(valid_table);
 
        DEBUG(2,("creating default valid table\n"));
@@ -128,6 +134,7 @@ void init_valid_table(void)
 }
 
 
+
 /*******************************************************************
  Write a string in (little-endian) unicode format. src is in
  the current DOS codepage. len is the length in bytes of the