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

Created on 2011-07-20 15:00 by hop, last changed 2016-08-21 00:24 by macpherson.scott.

Files
File name Uploaded Description Edit
pythonusage_mac.patch yuly, 2014-06-07 21:25 review
Messages (6)
msg140744 - (view) Author: Christoph Schindler (hop) Date: 2011-07-20 15:00
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-on-the-mac .
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 (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.
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 http://brew.sh/ - would it be worth mentioning this somewhere?
History
Date User Action Args
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