id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
16140	Logging documentation should describe how to configure logging handlers.	ShawnMilo	nobody	"The logging documentation [1] is incomplete and confusing to users unfamiliar with the logging module's dictionary configs, and Python's own docs are pretty poor on this so they don't take up the slack.

Specifically, I think our docs should explain how to specify the filename used by a handler that writes to a file, by adding the 'filename' key to the dictionary, and elaborate by saying that any kwarg accepted by any handler type's __init__ may be used here.

This tripped me up, and I just saw the same question asked on django-users by someone trying to figure out how to configure a SysLogHandler.

[1] https://docs.djangoproject.com/en/1.3/topics/logging/"	Uncategorized	closed	Documentation	1.3	Normal	worksforme			Unreviewed	0	0	0	0	1	0