traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Avoid a 301 permanent redirect. 

Part of SF patch #773007.

Also fixed a number of mostly cosmetic markup errors.
This commit is contained in:
Fred Drake 2003-07-22 01:09:22 +00:00
parent 644a08c735
commit f1c9869ab0
1 changed files with 18 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
Doc/mac/using.tex
View File

@ -2,7 +2,7 @@
\sectionauthor{Bob Savage}{bobsavage@mac.com} \sectionauthor{Bob Savage}{bobsavage@mac.com}
Using Python on a Macintosh, especially on Mac OS 9 (MacPython-OSX Using Python on a Macintosh, especially on Mac OS 9 (MacPython-OSX
includes a complete unix Python) can seem like something completely includes a complete \UNIX{} Python) can seem like something completely
different than using it on a \UNIX-like or Windows system. Most of the different than using it on a \UNIX-like or Windows system. Most of the
Python documentation, both the ``official'' documentation and published Python documentation, both the ``official'' documentation and published
books, describe only how Python is used on these systems, causing books, describe only how Python is used on these systems, causing
@ -28,11 +28,12 @@ What you get after installing is a number of things:
\begin{itemize} \begin{itemize}
\item A \file{MacPython-2.3} folder in your \file{Applications} \item A \file{MacPython-2.3} folder in your \file{Applications}
folder. In here you find the PythonIDE Integrated Development Environment; folder. In here you find the PythonIDE Integrated Development Environment;
PythonLauncher, which handles double-clicking Python scripts from the Finder; and PythonLauncher, which handles double-clicking Python scripts from
the Package Manager. the Finder; and the Package Manager.
\item A fairly standard unix commandline Python interpreter in \item A fairly standard \UNIX{} commandline Python interpreter in
\file{/usr/local/bin/python}, but without the usual \file{/usr/local/lib/python}. \file{/usr/local/bin/python}, but without the usual
\file{/usr/local/lib/python}.
\item A framework \file{/Library/Frameworks/Python.framework}, where \item A framework \file{/Library/Frameworks/Python.framework}, where
all the action really is, but which you usually do not have to be aware of. all the action really is, but which you usually do not have to be aware of.
@ -44,8 +45,8 @@ PythonIDE contains an Apple Help Viewer book called "MacPython Help"
which you can access through its help menu. If you are completely new to which you can access through its help menu. If you are completely new to
Python you should start reading the IDE introduction in that document. Python you should start reading the IDE introduction in that document.
If you are familiar with Python on other unix platforms you should read the If you are familiar with Python on other \UNIX{} platforms you should
section on running Python scripts from the unix shell. read the section on running Python scripts from the \UNIX{} shell.
\subsection{How to run a Python script} \subsection{How to run a Python script}
@ -55,14 +56,14 @@ menu when the IDE is running.
If you want to run Python scripts from the Terminal window command line If you want to run Python scripts from the Terminal window command line
or from the Finder you first need an editor to create your script. or from the Finder you first need an editor to create your script.
Mac OS X comes with a number of standard unix command line editors, Mac OS X comes with a number of standard \UNIX{} command line editors,
\program{vi} and \program{emacs} among them. If you want a more Mac-like \program{vi} and \program{emacs} among them. If you want a more Mac-like
editor \program{BBEdit} or \program{TextWrangler} from Bare Bones Software editor \program{BBEdit} or \program{TextWrangler} from Bare Bones Software
(see \url{http://www.barebones.com}) are good choices. Their freeware (see \url{http://www.barebones.com/products/bbedit/index.shtml}) are
\program{BBEdit Lite} is officially discontinued but still available. good choices. Their freeware \program{BBEdit Lite} is officially
\program{AppleWorks} or any other word processor that can save files discontinued but still available. \program{AppleWorks} or any other
in ASCII is also a possibility, but \program{TextEdit} is not: it saves in .rtf word processor that can save files in ASCII is also a possibility, but
format only. \program{TextEdit} is not: it saves in \file{.rtf} format only.
To run your script from the Terminal window you must make sure that To run your script from the Terminal window you must make sure that
\file{/usr/local/bin} is in your shell search path before \file{/usr/bin}, \file{/usr/local/bin} is in your shell search path before \file{/usr/bin},
@ -90,8 +91,9 @@ to start such scripts.
\subsection{configuration} \subsection{configuration}
MacPython honours all standard unix environment variables such as \envvar{PYTHONPATH}, MacPython honours all standard \UNIX{} environment variables such as
but setting these variables for programs started from the Finder is non-standard \envvar{PYTHONPATH}, but setting these variables for programs started
from the Finder is non-standard
as the Finder does not read your \file{.profile} or \file{.cshrc} at startup. as the Finder does not read your \file{.profile} or \file{.cshrc} at startup.
You need to create a file \file{\textasciitilde /.MacOSX/environment.plist}. You need to create a file \file{\textasciitilde /.MacOSX/environment.plist}.
See Apple's Technical Document QA1067 for details. See Apple's Technical Document QA1067 for details.
@ -103,7 +105,7 @@ Package Manager, see the MacPython Help Book for details.
The most recent release version as well as possible newer experimental The most recent release version as well as possible newer experimental
versions are best found at the MacPython page maintained by Jack versions are best found at the MacPython page maintained by Jack
Jansen: \url{http://www.cwi.nl/\textasciitilde jack/macpython.html}. Jansen: \url{http://homepages.cwi.nl/\textasciitilde jack/macpython.html}.
Please refer to the \file{README} included with your distribution for Please refer to the \file{README} included with your distribution for
the most up-to-date instructions. the most up-to-date instructions.