[issue20208] Clarify some things in porting HOWTO

2014-01-17 Thread Brett Cannon
Changes by Brett Cannon : -- resolution: -> fixed status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing list Uns

[issue20208] Clarify some things in porting HOWTO

2014-01-17 Thread Roundup Robot
Roundup Robot added the comment: New changeset 863b8e71cfee by Brett Cannon in branch 'default': Issue #20208: Clarify some things in the Python porting HOWTO. http://hg.python.org/cpython/rev/863b8e71cfee -- nosy: +python-dev ___ Python tracker

[issue20208] Clarify some things in porting HOWTO

2014-01-10 Thread Brett Cannon
Brett Cannon added the comment: There's actually no way to tweak that formatting as that is all done by Sphinx automatically. -- ___ Python tracker ___ _

[issue20208] Clarify some things in porting HOWTO

2014-01-10 Thread Rodrigo Bernardo Pimentel
Rodrigo Bernardo Pimentel added the comment: BTW, there remains another concern I mentioned on G+: """ A note on formatting: I found some of 4th- and 5th-level headings too subtle. For instance, http://docs.python.org/dev/howto/pyporting.html#from-future-import-absolute-import got me thinking

[issue20208] Clarify some things in porting HOWTO

2014-01-10 Thread Rodrigo Bernardo Pimentel
Rodrigo Bernardo Pimentel added the comment: I've created a patch that addresses the first criticism (explaining unicode_literals), as well as the first mention of print_function. It also addresses a small concern regarding "map", which I've mentioned in my G+ comment: """ Also, a friend was

[issue20208] Clarify some things in porting HOWTO

2014-01-09 Thread Dmitry Shachnev
Changes by Dmitry Shachnev : -- nosy: +mitya57 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pyt

[issue20208] Clarify some things in porting HOWTO

2014-01-09 Thread Brett Cannon
New submission from Brett Cannon: Reported on my G+ share of the latest reworking: """ The only part I found confusing is when you first introduce "from _future_ import unicode_literals" --- it looks like you forgot to explain what it does. It turns out that you explain it somewhat two paragra