Ticket #1703 enhancement new
Generated API docs for twisted.python.log are confusing
|Reported by:||predictive||Owned by:|
|Cc:||spiv, mwh, zooko@…, thijs||Branch:|
It's confusing that err is in twisted.python.log, but msg is in twisted.python.LogPublisher, and twisted.python.debug is deprecated. Since simplicity is the attractive part of twisted's logging vs python's, shouldn't debug be undeprecated and all three put in LogPublisher?
It would be even more attractive if twistd took a -v or --verbose switch that 'turned on' log.debug messages, so code doesn't have to be littered with "if self.debug: log.msg('foo')".