[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