* mu-log: add initial implementation of mu logging

src/mu-log.h

@@ -0,0 +1,65 @@
+/* 
+** Copyright (C) 2008, 2009 Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>
+**
+** This program is free software; you can redistribute it and/or modify
+** it under the terms of the GNU General Public License as published by
+** the Free Software Foundation; either version 3 of the License, or
+** (at your option) any later version.
+**  
+** This program is distributed in the hope that it will be useful,
+** but WITHOUT ANY WARRANTY; without even the implied warranty of
+** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+** GNU General Public License for more details.
+**  
+** You should have received a copy of the GNU General Public License
+** along with this program; if not, write to the Free Software Foundation,
+** Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
+**  
+*/
+
+#ifndef __MU_LOG_H__
+#define __MU_LOG_H__
+
+#include <glib.h>
+
+/* mu log is the global logging system */
+
+/** 
+ * write logging information to a file descriptor
+ * 
+ * @param fd an open file descriptor
+ * @param doclose if true, mu-log will close it upon mu_log_uninit
+ * @param debug include debug-level info
+ * 
+ * @return TRUE if initialization succeeds, FALSE otherwise
+ */
+gboolean mu_log_init_with_fd    (int fd, gboolean doclose, gboolean debug);
+
+
+/** 
+ * write logging information to a file descriptor
+ * 
+ * @param a filename to log to
+ * @param append append to logfile, instead of overwriting
+ * @param debug include debug-level information.
+ * 
+ * @return TRUE if initialization succeeds, FALSE otherwise
+ */
+gboolean mu_log_init_with_file  (const char* file, gboolean append,
+				 gboolean debug);
+
+/** 
+ * be absolutely silent, except for runtime errors, which will be
+ * written to stderr.
+ *  
+ * @return TRUE if initialization succeeds, FALSE otherwise
+ */
+gboolean mu_log_init_silence    (void);
+
+
+/** 
+ * unitialize the logging system, and free all resources
+ */
+void mu_log_uninit             (void);
+
+#endif /*__MU_LOG_H__*/