New submission from Nick Coghlan:

The codecs module currently refers out to PEP 383 as the documentation for the 
details of the ``surrogateescape`` error handler.

Instead (as per the recent python-dev discussion about not using PEPs as 
substitutes for reference docs), there should be a section providing details on 
surrogateescape directly in the library reference for the codecs module.

This may involve breaking out the current table of standard error handlers 
under its own heading rather than including it in the intro to codec base 
classes. Then the detailed description of surrogateescape could go under a 
dedicated subheading.

----------
messages: 199707
nosy: ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: Describe surrogateescape algorithm in the Library Reference
type: enhancement
versions: Python 3.4

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue19247>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to