-#define LOG_FATAL 0x0001
-#define LOG_DEBUG 0x0002
-#define LOG_WARN 0x0004
-#define LOG_LOG 0x0008
-#define LOG_ERRNO 0x0010 /* append strerror to message */
-#define LOG_FILE 0x0020
-#define LOG_APP 0x0040 /* For application level events such as new-connection */
-#define LOG_MALLOC 0x0080 /* debugging mallocs */
-#define LOG_NOTIME 0x0100 /* do not output date and time */
-#define LOG_APP2 0x0200 /* For application-level events, such as api calls */
-#define LOG_APP3 0x0400 /* For more application-level events */
-
-#define LOG_ALL (0xffff&~LOG_MALLOC&~LOG_NOTIME)
-
-#define LOG_DEFAULT_LEVEL (LOG_FATAL | LOG_ERRNO | LOG_LOG | LOG_WARN)
-
-#define logf yaz_log
-
-YAZ_EXPORT void yaz_log_init(int level, const char *prefix, const char *name);
-YAZ_EXPORT void yaz_log_init_file (const char *fname);
-YAZ_EXPORT void yaz_log_init_level (int level);
-YAZ_EXPORT void yaz_log_init_prefix (const char *prefix);
-YAZ_EXPORT void yaz_log_init_prefix2 (const char *prefix);
-/**
- * yaz_log_time_format sets the format of the timestamp. See man 3 strftime
- * Calling with "old" sets to the old format "11:55:06-02/11"
- * Calling with NULL or "" sets to the new format "20041102-115719"
- * If not called at all, the old format is used, for backward compatibility
- *
- * */
+/** \brief log level: fatal */
+#define YLOG_FATAL 0x00000001
+/** \brief log level: debugging */
+#define YLOG_DEBUG 0x00000002
+/** \brief log level: warning */
+#define YLOG_WARN 0x00000004
+/** \brief log level: log (regular) */
+#define YLOG_LOG 0x00000008
+/** \brief log level: append system error message */
+#define YLOG_ERRNO 0x00000010
+/** \brief log level: append thread Id */
+#define YLOG_TID 0x00000020
+/** \brief log level: application */
+#define YLOG_APP 0x00000040
+/** \brief log level: malloc debug */
+#define YLOG_MALLOC 0x00000080
+/** \brief log level: do not output date and time */
+#define YLOG_NOTIME 0x00000100
+/** \brief log level: application 2 */
+#define YLOG_APP2 0x00000200
+/** \brief log level: application 3 */
+#define YLOG_APP3 0x00000400
+/** \brief log level: flush */
+#define YLOG_FLUSH 0x00000800
+/** \brief dynamic log level start */
+#define YLOG_LOGLVL 0x00001000 /* log when modules query log levels */
+ /* this has to be a hard-coded bit, not to loop*/
+
+#define YLOG_ALL (0xffff&~YLOG_MALLOC&~YLOG_NOTIME)
+
+/** \brief default log level */
+#define YLOG_DEFAULT_LEVEL \
+ (YLOG_FATAL | YLOG_ERRNO | YLOG_LOG | YLOG_WARN | YLOG_FLUSH)
+/* not having flush here confuses Solaris users, who won't see any logs until
+ * (and if) the program exits normally */
+
+/** \brief last bit for regular log bits . Rest are dynamic */
+#define YLOG_LAST_BIT YLOG_LOGLVL
+
+/** \brief sets level, prefix and filename for logging
+ \param level log level
+ \param prefix log message prefix
+ \param fname filename
+
+ If fname is NULL, the filename logging is not changed.
+*/
+YAZ_EXPORT void yaz_log_init(int level, const char *prefix, const char *fname);
+
+/** \brief sets log file
+ \param fname filename
+
+ A filename of NULL makes the log to be completely disabled.
+ A filename which is the empty string ("") makes the system
+ log to stderr (which is also the default). Otherwise the
+ filename given is used.
+*/
+YAZ_EXPORT void yaz_log_init_file(const char *fname);
+
+/** \brief sets log level
+ \param level (combination of YLOG_..)
+*/
+YAZ_EXPORT void yaz_log_init_level(int level);
+
+/** \brief sets log message prefix
+ \param prefix log message prefix
+*/
+YAZ_EXPORT void yaz_log_init_prefix(const char *prefix);
+
+/** \brief sets second log message prefix
+ \param prefix log message prefix
+*/
+YAZ_EXPORT void yaz_log_init_prefix2(const char *prefix);
+
+/** \brief sets time format for log mesages
+ \param fmt format (strftime)
+
+ Sets the format of the timestamp. See man 3 strftime.
+ Calling with "old" sets to the old format "11:55:06-02/11"
+ Calling with NULL or "" sets to the new format "20041102-115719"
+ If not called at all, the old format is used, for backward compatibility
+*/