#14616: Recommend a leading underscore on module-level loggers in docs
------------------------------------+---------------------------------------
Reporter: dgolden_ichec | Owner: nobody
Status: closed | Milestone:
Component: Documentation | Version: SVN
Resolution: wontfix | Keywords:
Stage: Unreviewed | Has_patch: 0
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Changes (by russellm):
* status: new => closed
* needs_better_patch: => 0
* resolution: => wontfix
* needs_tests: => 0
* needs_docs: => 0
Comment:
I don't deny that {{{_log}}} is a common idiom, but the real fix here is
"don't use {{{from blah import *}}}", or, in a refined form "don't use
{{{from blah import *}}} unless the module author has used {{{__all__}}}
or has explicitly marked a module as safe for {{{import *}}}". This
transcends anything in the logging code -- it's just good advice in
general.
However, I'm going to mark this wontfix. There is a limit to how many
times we can say "no, really, you need to learn Python" in Django's docs
before Django's docs become a Python tutorial, and that's not what our
docs are for.
--
Ticket URL: <http://code.djangoproject.com/ticket/14616#comment:1>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to django-upda...@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
