[Python-Dev] Adding examples to PEP 263

Fredrik Lundh fredrik at pythonware.com
Fri Nov 4 10:05:40 CET 2005


the runtime warning you get when you use non-ascii characters in
python source code points the poor user to this page:

    http://www.python.org/peps/pep-0263.html

which tells the user to add a

    # -*- coding: <encoding name> -*-

to the source, and then provides a more detailed syntax description
as a RE pattern.  to help people that didn't grow up with emacs, and
don't speak fluent RE, and/or prefer to skim documentation, it would
be a quite helpful if the page also contained a few examples; e.g.

# -*- coding: utf-8 -*-
# -*- coding: iso-8859-1 -*-

can anyone with SVN write access perhaps add this?

(I'd probably add a note to the top of the page for anyone who arrives
there via a Python error message, which summarizes the pep and provides
an example or two; abstracts and rationales are nice, but if you're just a
plain user, a "do this; here's how it works; further discussion below" style
is a bit more practical...)

</F>





More information about the Python-Dev mailing list