The current strftime documentation isn't very helpful. It doesn't have examples, and the ordering is unhelpful.

I've also moved some format-specific notes into the notes below the format-string-table, because the format string table is what 98%* of people care about.

TODO before this can be merged:
- Clean up note order
- Check that it works with the Python 3 docs

*: based on a sample size of 1

Thanks for the patch, looks good.  I’d put the versionadded block at the end of the note rather than the beginning, to match usual conventions.

Ah, yes — thanks Éric. I've fiddled with the wording on the %f note a bit so it makes more sense along with the versionadded, and removed the versionadded text, which is basically identical to the note and description.

Ok, I've added some locale examples and fixed up the note numbering. See diff in file29839, and there is a live version to preview here: http://hul.wolever.net/python-doc/library/datetime.html#strftime-and-strptime-behavior

If I can get a +1 on this, I'll port it to Python 3.

Fixed a misleading note about Unicode in localized formatters in file29841.

Looks good.

New changeset adbc9789a5e4 by David Wolever in branch '2.7':
Issue #17701: Improving strftime documentation
http://hg.python.org/cpython/rev/adbc9789a5e4

New changeset 1d4b02d8fa8a by David Wolever in branch '3.3':
Issue #17701: Improving strftime documentation.
http://hg.python.org/cpython/rev/1d4b02d8fa8a

New changeset ab550dac6209 by David Wolever in branch 'default':
Merge issue #17701: Improving strftime documentation.
http://hg.python.org/cpython/rev/ab550dac6209

Done, pushed to 2.7, 3.3, default.