[issue8219] Facility and priority values/constants not documented for SysLogHandler

[Ville Skyttä]

New submission from Ville Skyttä <ville.skytta at iki.fi>:

http://docs.python.org/dev/py3k/library/logging.html#logging.handlers.SysLogHandler

What to use as the value for facility for SysLogHandler's constructor is not documented.  There's a reference to LOG_USER, but it's kind of vague because it doesn't specify what LOG_USER it refers to - there's no mention that SysLogHandler itself has these constants.  And the corresponding documented values from the syslog module are not compatible with the ones SysLogHandler works with.

Similarly, the values for facility and priority for SysLogHandler.encodePriority() are not documented, it just talks about integers and strings without saying what they are.

I suggest documenting all the SysLogHandler.LOG_* constants and the priority and facility mapping strings in SysLogHandler's priority_names and facility_names dicts.

----------
assignee: georg.brandl
components: Documentation
messages: 101629
nosy: georg.brandl, scop
severity: normal
status: open
title: Facility and priority values/constants not documented for SysLogHandler
type: feature request

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue8219>
_______________________________________