[Doc-SIG] Installing Python modules doc -- please add a few items

[John M. Gabriele]

I just sent the following {see below} message to docs
at python.org, but then discovered this ML, subscribed,
and am re-sending it to this list:



Request for possible additions to the "Installing Python
Modules" doc:

1. When I want to install a package in 2 steps, first
building in a separate build dir (--build-base=~/temp/foo)
then install in my own packages directory
(--home=~/python_pkgs), please mention in the doc how
setup.py knows I've already run the build. That is, when
I tell setup.py to install, how does it know that I
previously ran a build, and where those build products are
waiting?

2. At the very beginning of the doc, you might mention the
difference between installing a single module, and
installing a package containing a number of modules. That
is, do developers use distutils when they are providing
only one module (as opposed to a package full of modules)?

3. It might also be beneficial to note in the doc why you
run the command as "python setup.py" instead of
"./setup.py".

4. It would be nice to have a comment about what lands
in your '--build-base' when you've got a package that
only contains some pure Python modules. I guess setup.py
simply copies the .py files to the build directory?

I could make these changes/additions myself, but would
need to know:

A. Where to get the source from, and
B. The answers to the above questions. :)

BTW, I don't know if this message is going to a ML or
not. If it is, and I need to subscribe to get a reply,
please point me in the right direction.

Thanks,
---John




__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com