PEP 249: Replace StandardError with Exception

[malemburg]

To avoid confusion when using the DB-API 2.0 in the context of Python 3.

Add a note about a future upgrade to the Warning base class.

Fixes#2776.

[vstinner]

cc @erlend-aasland

[vstinner]

cc @methane

[Rosuav]

LGTM. Not sure the Py2 historical note is going to matter much but it's good to have it in case anyone's wondering as they make upgrades.

[malemburg]

Posted RFC to DB-SIG: https://mail.python.org/pipermail/db-sig/2022-September/006329.html

[malemburg]

Thank you all for your reviews.

[CAM-Gerlach]

Late to the party, was busy with the Artemis 1 launch, but just FYI as of #2702 you can now use intersphinx links to be able to do e.g. :exc:`Exception`, etc, which will not only format it as an exception, but also link to the relevant exception, if you want.

[malemburg]

On 14.09.2022 05:27, C.A.M. Gerlach wrote: Late to the party, was busy with the Artemis 1 launch, but just FYI as of #2702 <#2702> you can now use intersphinx links to be able to do e.g. |:exc:`Exception`|, etc, which will not only format it as an exception, but also link to the relevant exception, if you want.

Thanks for the tip. Is there a reference somewhere of what formatting can be used for PEPs ?

…

-- Marc-Andre Lemburg http://www.malemburg.com/

[CAM-Gerlach]

Yup, its standard Sphinx reST; PEP-12 both gives an intro to reST as well as PEP-specific guidance, but per #2337 I've been meaning to update it to focus just on the latter and for the rest, refer to the more complete and up to date Sphinx reST primer (which itself is just a mildly updated version of the reST primer in the CPython devguide, not to be confused with the earlier and more limited docutils reST primer). There's also the docutils Quick Reference and full reference to basic reST, and the Sphinx Directives, Domains and Roles pages for the constructs Sphinx adds.