[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