For http://docs.python.org/howto/unicode.html (that's Python 2.7.3) and http://docs.python.org/release/3.1.5/howto/unicode.html the first paragraph states "(This HOWTO has not yet been updated to cover the 3.x versions of Python.)".  I suggest this is changed to read something like "Release 1.12 onwards of this document covers the 3.2 Python versions onwards."

I wonder why the note must be there at all.  None of the 2.x docs have been updated to cover the 3.x versions of Python.  Otherwise, every 2.x page could use such a disclaimer.

Here is where the note was added:

http://hg.python.org/cpython/rev/bdef454f7212

I'd happily settle on seeing this historical note removed from the 2.7.3 docs.  I'm unsure about the best approach for 3.1.5.  Who's done the most work on unicode to answer this one, someone working on #16061 possibly?

I don't think there is a need to update the 3.1.x version of the documentation in that respect.

Before the disclaimer can be removed, all statements of the document should be reviewed. From a shallow glance, the section on "Python 2.x's support" should be changed to "Python's support". The reference to Marc-Andre Lemburg's presentation should be removed, as it's not current anymore.

The 2.7 version of the document is fine as it stands; it indeed doesn't talk about 3.x.

See also #4153

> I don't think there is a need to update the 3.1.x version of the documentation in that respect.
> versions: +Python 3.3, Python 3.4 -Python 3.1

This issue was just about the 2.7 version.  3.x doesn't contain the language mentioned by the original commenter.  If 2.7 should not be changed, this issue should be closed.  Or are you suggesting other updates to the 3.x docs?

> 3.x doesn't contain the language mentioned by the original commenter.

3.2 onwards I mean.

Ah, I missed that.

I'm skeptical that the proposed change is an improvement - how would the reader know how to find version 1.12 of the document? I'm also skeptical that removal of the note in 2.7 is useful: people finding the document in Google would misunderstand.

My proposal: "This version of the document talks about Unicode support in Python 2.x. See <URL> for the Python 3 version."

That proposal sounds fine to me.

The mvl proposal fine by me too, thanks guys.

Attaching proposed patch.

I would not rephrase the first two lines.

Nice trick of using py3k in the link.

> I would not rephrase the first two lines.

Why not?  The current language focuses on the negative ("explaining problems") while we prefer an affirmative tone:

http://docs.python.org/devguide/documenting.html#affirmative-tone

New changeset c59884f4bc8d by Chris Jerdonek in branch '2.7':
Issue #16227: Add to 2.x Unicode HOWTO a link to the Python 3 version.
http://hg.python.org/cpython/rev/c59884f4bc8d

Committed without changing the first sentence, as Éric preferred.

Thanks for the report, Mark!