- and a backtrace and then swallows it. log is the Logging instance to
- log to (using the "error" level for the message, and "debug" for the
- backtrace), msg is the message to log (which must contain a %s into
- which the exception message is interpolated).
+ and a backtrace and then swallows it. The exception is logged using
+ the "error" level for the message, and "debug" for the backtrace.
+
+ log is the Logger instance to log to. If this is not present, the
+ decorated function should be a method of an object that contains a
+ "log" attribute that contains a Logger instance.
+
+ msg is the message to log (which must contain a %s into which the
+ exception message is interpolated).
+