# HG changeset patch
# User Sascha Wilde <wilde@intevation.de>
# Date 1396000214 -3600
# Node ID 774e944c395b001ed959275fd61266c4337d8e53
# Parent  c342b93c5bd141591773938a3f1ed28f45aefbc9
Cleand up doku.

diff -r c342b93c5bd1 -r 774e944c395b cinst/mozilla.c
--- a/cinst/mozilla.c	Fri Mar 28 10:45:55 2014 +0100
+++ b/cinst/mozilla.c	Fri Mar 28 10:50:14 2014 +0100
@@ -31,23 +31,6 @@
  *
  */
 
-/* @brief IniParser for mozilla profiles.ini
- *
- * Parse data to find values formed in
- *
- * [Profile99]
- * IsRelative=1
- * Path=Profiles/fooo.bar
- *
- * or
- * [Profile0]
- * IsRelative=0
- * Path=c:\foo\bar\baz
- *
- * Mozilla also accepts the ini file on Windows even if it is UTF-16
- * encoded.
- * */
-
 #include <dirent.h>
 #include <cert.h>
 #include <certt.h>
@@ -122,7 +105,21 @@
 /**
  * @brief Get a list of all mozilla profile directories
  *
- * Read the profiles.ini and extract all profile paths from that.
+ * Parse the profiles.ini and extract all profile paths from that.
+ * The expected data is in the form:
+ *
+ * [Profile99]
+ * IsRelative=1
+ * Path=Example/fooo.bar
+ *
+ * or
+ * [Profile0]
+ * IsRelative=0
+ * Path=c:\foo\bar\baz
+ *
+ * Mozilla also accepts the ini file on Windows even if it is UTF-16
+ * encoded but never writes UTF-16 on its own.  So currently we ignore
+ * this special case.
  *
  * @param[in] inifile_name path of the profile.ini to read.
  * @return NULL terminated array of strings containing containing the