document DEFINE key in return value

[imager.git] / log.h

diff --git a/log.h b/log.h
index 12d3467b329a20c2c1290122f3a7d792381f48aa..5b1f483957b0bdecc315125fdf3422508bed75d3 100644 (file)
--- a/log.h
+++ b/log.h
@@ -15,6 +15,18 @@ void i_init_log( const char *name, int onoff );
 void i_loog(int level,const char *msg, ... );
 void i_fatal ( int exitcode,const char *fmt, ... );
 
+/*
+=item mm_log((level, format, ...))
+=category Logging
+
+This is the main entry point to logging. Note that the extra set of
+parentheses are required due to limitations in C89 macros.
+
+This will format a string with the current file and line number to the
+log file if logging is enabled.
+
+=cut
+*/
 
 #ifdef IMAGER_LOG
 #define mm_log(x) { i_lhead(__FILE__,__LINE__); i_loog x; }