[docs] Remove the relatively advanced content from section 2 in tutorial (issue 16827)
berker.peksag at gmail.com
berker.peksag at gmail.com
Thu Apr 24 14:55:56 CEST 2014
http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst
File Doc/tutorial/appendix.rst (right):
http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode43
Doc/tutorial/appendix.rst:43: #! /usr/bin/env python3.5
Minor nit: I would remove the whitespace after the "#!" part. See
https://en.wikipedia.org/wiki/Shebang_%28Unix%29 for example usages.
http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode53
Doc/tutorial/appendix.rst:53: :program:`chmod` command::
Another nit: You could use a ``.. code-block:: bash`` directive to
highlight the examples.
http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode92
Doc/tutorial/appendix.rst:92: exec(open(filename).read())
It would be good to use more Pythonic code here:
with open(filename) as fobj:
startup_file = fobj.read()
exec(startup_file)
http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode102
Doc/tutorial/appendix.rst:102: of your user site-packages directory.
Start Python and run this code:
code: -> code::
http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode106
Doc/tutorial/appendix.rst:106:
'/home/user/.local/lib/python3.2/site-packages'
python3.2 -> python3.5
http://bugs.python.org/review/16827/
More information about the docs
mailing list