[Distutils] Draft of new setuptools installation instructions

[Bob Ippolito]

On 10/3/06, Phillip J. Eby <pje at telecommunity.com> wrote:
>
> Cygwin, Mac OS X, Linux, Other
> ==============================
>
> 1. Download the appropriate egg for your version of Python (e.g.
>     ``setuptools-0.6c4-py2.4.egg``).  Do NOT rename it.
>
> 2. Make it executable (e.g. ``chmod +x setuptools-0.6c4-py2.4.egg``)
>
> 3. Run it (e.g. ``./setuptools-0.6c4-py2.4.egg``).  Setuptools will
>     install itself using the matching version of Python (e.g.
>     ``python2.4``), and will place the ``easy_install`` executable
>     in the default location for installing Python scripts.
>
> If you want to install setuptools to somewhere other than ``site-packages``
> or your default distutils installation locations for libraries and scripts, you
> may use EasyInstall command-line options such as ``--prefix``,
> ``--install-dir``, and so on.  You can use ``--help`` to get a full options
> list, but we recommend consulting the `EasyInstall manual`_ for detailed
> instructions, especially `the section on custom installation locations`_.

Wouldn't it be easier to just tell them to do "sh
./setuptools-0.6c4-py2.4.egg" instead of marking it executable first?

-bob