[Doc-SIG] Non-ASCII Characters in reST (was: [Doc-SIG] docutils f eedback )

David Goodger goodger@users.sourceforge.net
Mon, 17 Jun 2002 23:16:04 -0400


> On Mon, Jun 17, 2002, David Goodger wrote:
>> I've got an "--encoding" option in docutils/frontend.py, but it's
>> commented out as unimplemented.  I've heard that such a command-line
>> option is a **bad thing**, as are inline magic comments or directives.
>> There's a comment, "Take default encoding & language from locale?".  I
>> don't know how best to proceed.  I'd like to make the *right* decision
>> here, not just "good enough for now".  That's one of the reasons I
>> haven't implemented the encoding issue yet.  I've seen this debated,
>> on Python-Dev and elsewhere, but I have yet to be shown "the one true
>> way" or convinced that it *is* the right way.

Aahz wrote:
> See PEP 263.  That way, at worst you're compatible with Python.

That's what I'm talking about; I'm not convinced by PEP 263.  I have strong
reservations about the magic comment it proposes.  I hesitate to add similar
recognition logic to Docutils/reStructuredText.  I'm no expert, but it seems
flawed somehow.  It could very well be the best solution, but it doesn't
seem that way to me.

Does anybody know of any good, authoritative references on the subject?

-- 
David Goodger  <goodger@users.sourceforge.net>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/