[issue12594] Docs for py3k still refer to "MacPython 2.5 folder"
New submission from Christoph Schindler hop@30hopsmax.at:
In http://docs.python.org/py3k/using/mac.html#getting-and-installing-macpython and http://docs.python.org/py3k/using/mac.html#distributing-python-applications-... .
---------- assignee: docs@python components: Documentation messages: 140744 nosy: docs@python, hop priority: normal severity: normal status: open title: Docs for py3k still refer to "MacPython 2.5 folder" versions: Python 3.1, Python 3.2
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Ned Deily nad@acm.org added the comment:
Thanks for the report. The whole "Using Python on a Macintosh" section is very out-of-date and needs a major update.
---------- assignee: docs@python -> ned.deily nosy: +ned.deily stage: -> needs patch versions: +Python 2.7, Python 3.3 -Python 3.1
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Changes by Ned Deily nad@acm.org:
---------- title: Docs for py3k still refer to "MacPython 2.5 folder" -> Docs for "Using Python on a Macintosh" needs to be updated versions: +Python 3.4, Python 3.5 -Python 3.2, Python 3.3
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Yuly Tenorio added the comment:
Built with sphinx. No RST errors.
---------- keywords: +patch nosy: +yuly Added file: http://bugs.python.org/file35526/pythonusage_mac.patch
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Ned Deily added the comment:
Thank you for the patch, Yuly! You've made some good improvements to the current page. Because the current section is so old and out-of-sync with current practices (as you've noted in your changes) and with the nuances of Python on OS X, a more comprehensive restructuring is needed. I don't think that trying to refine the section interactively is going to be an efficient process but I will definitely use your suggested changes as a basis. I assume you have signed (or will be signing) the PSF contributor agreement. Thanks again! P.S. When submitting patches, don't forget to run patchcheck first (https://docs.python.org/devguide/patch.html#generation). It will detect and fix trailing whitespace in lines that would otherwise prevent a patch from being committed in the main cpython hg repo.
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Yuly Tenorio added the comment:
Ok, I will definitely use that checker next time :) thanks! Thanks Ned!
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Changes by Scott Macpherson scott@zerosleeps.com:
---------- nosy: +macpherson.scott
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Scott Macpherson added the comment:
I'd like to help out with this issue if I can. This page in the documentation is really showing it's age now.
* I think referring to "OS X" (soon to be "MacOS") instead of "Mac" or "Macintosh" would more accurate. * The opening paragraph of section 4.1 only refers to OS X 10.8, which was released over 4 years ago. * Is there any value in listing text editors in section 4.1.1? Editors frequently come-and-go. * I suspect a large number of Python 3 developers running OS X use http://brew.sh/ - would it be worth mentioning this somewhere?
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue12594 _______________________________________
Change by Ronald Oussoren ronaldoussoren@mac.com:
---------- components: +macOS nosy: +ronaldoussoren
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue12594 _______________________________________
cmhzc chmhzc@126.com added the comment:
According to the official tutorial on virtual environment,
""" This will create the tutorial-env directory if it doesn’t exist, and also create directories inside it containing a copy of the Python interpreter, **the standard library**, and various supporting files. """
But according to PEP 405 and the actual behavior of venv, the standard library won't be copied. I'm not sure if I'm having a misunderstanding of this expression.
---------- nosy: +cmhzc versions: -Python 2.7, Python 3.4, Python 3.5
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue12594 _______________________________________
cmhzc chmhzc@126.com added the comment:
sorry for posting a wrong message in this issue tracker, this is my first time using the Python issue tracker
----------
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue12594 _______________________________________
Change by Tomy Hsieh tomy0000000@gmail.com:
---------- nosy: +tomy0000000
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue12594 _______________________________________
participants (7)
-
Christoph Schindler -
cmhzc
-
Ned Deily
-
Ronald Oussoren
-
Scott Macpherson
-
Tomy Hsieh
-
Yuly Tenorio