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

2010-03-24 Thread Ville Skyttä

New submission from Ville Skyttä ville.sky...@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 rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Eric Smith

Changes by Eric Smith e...@trueblade.com:


--
nosy: +eric.smith

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Eric Smith

Changes by Eric Smith e...@trueblade.com:


--
nosy: +vinay.sajip
priority:  - normal
versions: +Python 2.6, Python 2.7, Python 3.1, Python 3.2

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Vinay Sajip

Changes by Vinay Sajip vinay_sa...@yahoo.co.uk:


--
assignee: georg.brandl - vinay.sajip

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Vinay Sajip

Vinay Sajip vinay_sa...@yahoo.co.uk added the comment:

Update showing strings and corresponding symbolic integers checked into trunk 
(r79373).

--
resolution:  - fixed
status: open - closed

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Eric Smith

Eric Smith e...@trueblade.com added the comment:

It still doesn't say that the LOG_ constants are defined on SysLogHandler. Or 
is the intention that the user just use the strings?

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Vinay Sajip

Vinay Sajip vinay_sa...@yahoo.co.uk added the comment:

 From: Eric Smith rep...@bugs.python.org

 It still doesn't say that the LOG_ constants are defined on 
 SysLogHandler. Or is the intention that the user just use the 
 strings?

Whoops, now fixed (I think).

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



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

2010-03-24 Thread Eric Smith

Eric Smith e...@trueblade.com added the comment:

 Vinay Sajip vinay_sa...@yahoo.co.uk added the comment:
 Whoops, now fixed (I think).

Looks good. Thanks!

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue8219
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com