[issue39913] Document warnings.WarningMessage ?

2020-03-09 Thread Rémi Lapeyre

Rémi Lapeyre  added the comment:

warnings.WarningMessage was added in https://bugs.python.org/issue26568 at the 
same time than _showwarnmsg_impl() and _formatwarnmsg_impl().

The goal was to have public functions that took them instead of multiple 
arguments so it could be easily extended in the future. It looks like it never 
happened and as of today there is no way to use warnings.WarningMessage in user 
code.

Maybe it is time to bikeshed the names and add them?

--
nosy: +remi.lapeyre, vstinner

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue39913] Document warnings.WarningMessage ?

2020-03-09 Thread daniel hahler


New submission from daniel hahler :

I've noticed that `warnings.WarningMessage` is not documented, i.e. it does not 
show up in the intersphinx object list.

I'm not sure how to document it best, but maybe just describing its attributes?

Ref: 
https://github.com/blueyed/cpython/blob/598d29c51c7b5a77f71eed0f615eb0b3865a4085/Lib/warnings.py#L398-L417

--
assignee: docs@python
components: Documentation
messages: 363735
nosy: blueyed, docs@python
priority: normal
severity: normal
status: open
title: Document warnings.WarningMessage ?

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com