Author belopolsky
Recipients belopolsky, docs@python, eric.araujo, georg.brandl
Date 2010-11-18.01:01:07
SpamBayes Score 0.0
Marked as misclassified No
Message-id <>
In-reply-to <>
On Wed, Nov 17, 2010 at 7:28 PM, Éric Araujo <> wrote:
> Éric Araujo <> added the comment:
> Looks good.  Some remarks:
> 1) I assume you have checked that this code does not produce two newlines (one in the string,
> one from the print function or write method):

Yes, it should be clear from the output that I presented above.  I
think TextDoc.indent() takes care of the trailing '\n'.

That won't work for maintenance branches. (I am not even sure docs are
built for maintenance branches.)

> 3) People seem to go the the most recent version of the docs, not the release-specific version
> (I haven’t found the python-dev thread about that, maybe you remember it).
>  The version{add,chang}ed directives help adjust the doc for older versions.
>  So, are you sure it’s useful to make the links release-specific?

Certainly. If we are talking about the most authoritative source.  I
don't think versionadded/changed tags are reliable enough and you
don't want to send users to wrong docs when APIs change between
releases.   I am not so sure about micro-version, but there is no easy
way to construct the latest micro-version link without changes on  If there was say latest/X.Y, I would use that.  Wait -
there is:  Would you prefer that?
Date User Action Args
2010-11-18 01:01:10belopolskysetrecipients: + belopolsky, georg.brandl, eric.araujo, docs@python
2010-11-18 01:01:07belopolskylinkissue10446 messages
2010-11-18 01:01:07belopolskycreate