handle failure to clone the log filehandle when cloning the Imager context

[imager.git] / log.h

diff --git a/log.h b/log.h
index c54b58ae878ff9e3ffd91c184da1ba14c146cbd4..0dcb74be07bf95ef86b2e785e22eb9f4b9720b91 100644 (file)
--- a/log.h
+++ b/log.h
@@ -23,7 +23,7 @@ void i_loog(int level,const char *msg, ... ) I_FORMAT_ATTR(2,3);
 void im_loog(pIMCTX, int level,const char *msg, ... ) I_FORMAT_ATTR(3,4);
 
 /*
-=item mm_log((level, format, ...))
+=item im_log((aIMCTX, level, format, ...))
 =category Logging
 
 This is the main entry point to logging. Note that the extra set of
@@ -32,6 +32,13 @@ 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.
 
+This must be called with a context object defined by one of the
+C<dIMCTX> macros in scope.
+
+This can also be called as C<mm_log((level, format, args))> in which
+case the currently active context is used and any in scope context is
+ignored.
+
 =cut
 */