[docs] I suspect a reversal

Edward Welbourne eddy at chaos.org.uk
Thu May 9 22:21:52 CEST 2013


Hi doc-team,

On
http://docs.python.org/3/library/codecs.html
under codecs.register, I see the description: <quote>

streamreader and streamwriter: These have to be factory functions
providing the following interface:

  factory(stream, errors='strict')

The factory functions must return objects providing the interfaces
defined by the base classes StreamWriter and StreamReader, respectively.

</quote> and am instantly suspicious: apparently, streamreader should
have the interface of StreamWriter and streamwrite that of StreamReader.
This is either a doc bug or a horribly bad choice of names for the
.register() function's parameters !

	Eddy.


More information about the docs mailing list