This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Title: Docs for "Using Python on a Macintosh" needs to be updated
Type: Stage: needs patch
Components: Documentation, macOS Versions:
Status: open Resolution:
Dependencies: Superseder:
Assigned To: ned.deily Nosy List: cmhzc, docs@python, hop, macpherson.scott, ned.deily, ronaldoussoren, tomy0000000, yuly
Priority: normal Keywords: patch

Created on 2011-07-20 15:00 by hop, last changed 2022-04-11 14:57 by admin.

File name Uploaded Description Edit
pythonusage_mac.patch yuly, 2014-06-07 21:25 review
Messages (8)
msg140744 - (view) Author: Christoph Schindler (hop) Date: 2011-07-20 15:00
In and .
msg140761 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2011-07-20 18:53
Thanks for the report.  The whole "Using Python on a Macintosh" section is very out-of-date and needs a major update.
msg219980 - (view) Author: Yuly Tenorio (yuly) * Date: 2014-06-07 21:25
Built with sphinx. No RST errors.
msg219989 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2014-06-07 22:20
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 (  It will detect and fix trailing whitespace in lines that would otherwise prevent a patch from being committed in the main cpython hg repo.
msg219998 - (view) Author: Yuly Tenorio (yuly) * Date: 2014-06-07 23:26
Ok, I will definitely use that checker next time :) thanks!
Thanks Ned!
msg273253 - (view) Author: Scott Macpherson (macpherson.scott) Date: 2016-08-21 00:24
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 - would it be worth mentioning this somewhere?
msg387651 - (view) Author: cmhzc (cmhzc) * Date: 2021-02-25 08:35
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.
msg387654 - (view) Author: cmhzc (cmhzc) * Date: 2021-02-25 08:47
sorry for posting a wrong message in this issue tracker, this is my first time using the Python issue tracker
Date User Action Args
2022-04-11 14:57:19adminsetgithub: 56803
2021-03-04 11:54:11tomy0000000setnosy: + tomy0000000
2021-02-25 08:47:02cmhzcsetmessages: + msg387654
2021-02-25 08:35:48cmhzcsetnosy: + cmhzc

messages: + msg387651
versions: - Python 2.7, Python 3.4, Python 3.5
2020-11-16 20:02:41ronaldoussorensetnosy: + ronaldoussoren
components: + macOS
2016-08-21 00:24:41macpherson.scottsetmessages: + msg273253
2016-08-21 00:14:55macpherson.scottsetnosy: + macpherson.scott
2014-06-07 23:26:46yulysetmessages: + msg219998
2014-06-07 22:20:23ned.deilysetmessages: + msg219989
2014-06-07 21:25:17yulysetfiles: + pythonusage_mac.patch

nosy: + yuly
messages: + msg219980

keywords: + patch
2014-06-07 20:01:03ned.deilylinkissue21689 superseder
2014-06-07 20:00:19ned.deilysettitle: 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
2011-07-20 18:53:00ned.deilysetversions: + Python 2.7, Python 3.3, - Python 3.1
nosy: + ned.deily

messages: + msg140761

assignee: docs@python -> ned.deily
stage: needs patch
2011-07-20 15:00:56hopcreate