Improve Windows and Mac OS-specific instructions for running the
setup script. Also added a comment about how it *should* work on Mac OS.
diff --git a/Doc/inst/inst.tex b/Doc/inst/inst.tex
index 967df55..4409501 100644
--- a/Doc/inst/inst.tex
+++ b/Doc/inst/inst.tex
@@ -168,8 +168,8 @@
python setup.py install
\end{verbatim}
On Unix, you'd run this command from a shell prompt; on Windows, you
-have to open a command prompt window and do it there; on Mac~OS ...
-\XXX{what the heck do you do on Mac~OS?}.
+have to open a command prompt window (``DOS box'') and do it there; on
+Mac~OS, things are a tad more complicated (see below).
\subsection{Platform variations}
@@ -185,18 +185,35 @@
python setup.py install
\end{verbatim}
-On Windows, you'd probably unpack the archive before opening the command
-prompt. If you downloaded the archive file to
-\file{C:\textbackslash{}Temp}, then it probably unpacked (depending on
-your software) into
-\file{C:\textbackslash{}Temp\textbackslash{}foo-1.0}; from the command
-prompt window, you would then run
+On Windows, you'd probably download \file{foo-1.0.zip}. If you
+downloaded the archive file to \file{C:\textbackslash{}Temp}, then it
+would unpack into \file{C:\textbackslash{}Temp\textbackslash{}foo-1.0};
+you can use either a GUI archive manipulator (such as WinZip) or a
+command-line tool (such as \program{unzip} or \program{pkunzip}) to
+unpack the archive. Then, open a command prompt window (``DOS box''),
+and run:
\begin{verbatim}
-cd c:\temp\foo-1.0
+cd c:\Temp\foo-1.0
python setup.py install
\end{verbatim}
-On Mac~OS, ... \XXX{again, how do you run Python scripts on Mac~OS?}
+On Mac~OS, you have to go through a bit more effort to supply
+command-line arguments to the setup script:
+\begin{itemize}
+\item hit option-double-click on the script's icon (or option-drop it
+ onto the Python interpreter's icon)
+\item press the ``Set unix-style command line'' button
+\item set the ``Keep stdio window open on termination'' if you're
+ interested in seeing the output of the setup script (which is usually
+ voluminous and often useful)
+\item (??) when the command-line dialog pops up, enter ``install'' (you
+ can, of course, enter any Distutils command-line as described in this
+ document or in the ``Distributing Python Modules'' document: just
+ leave of the initial \code{python setup.py} and you'll be fine)
+\end{itemize}
+\XXX{this should change: every Distutils setup script will need
+ command-line arguments for every run (and should probably keep stdout
+ around), so all this should happen automatically for setup scripts}
\subsection{Splitting the job up}