gh-64612: Update error handlers list under open()
#137304
Conversation
There was a problem hiding this comment.
I'm not convinced the two-column table, with name in the first column and prose in the second, is better than a buletted list. (Especially as two tables with unaligned columns.)
The "reproduced below for convenience" sounds like the tables should be the same. Perhaps "summarized below for convenience" would be better, with additional details left out?
| when writing data. This is useful for processing files in an | ||
| unknown encoding. | ||
| * - ``'surrogatepass'`` | ||
| - Only available for Unicode codecs. |
There was a problem hiding this comment.
Aren't these all Unicode codecs?
| - Only available for Unicode codecs. | |
| - Only available for UTF-8, UTF-16 and UTF-32 codecs. |
There was a problem hiding this comment.
The codecs documentation lists the little/big endian variants, though I think wr can be less specific here.
I see, it is a table in the codecs docs and so, in an attempt to make them consistent converted it to (albeit a more convenient form of) a table. |
📚 Documentation preview 📚: https://cpython-previews--137304.org.readthedocs.build/