[Doc-SIG] Documentation: "Installing Python Modules"

Greg Ward gward@python.net
Wed, 23 Feb 2000 22:30:18 -0500

Hi all --

well, I finally sat down and started spewing Distutils documentation.
My plan is to write two howto-style manuals (maybe a bit bigger than
"Documenting Python", but along those lines) to be included in the 1.6
manual set.  (Clever of me to announce this intention in public before
mentioning it to Fred or Guido, just to make it harder for them to tell
me to get stuffed.  ;-)

The two manuals are tentatively entitled:

   Installing Python Modules
   Distributing Python Modules

So far, I have written one section of the "Installing" manual, entitled
"Custom Installation (Unix)".  This one is kind of important: it
explains how to use the Distutils to install modules to any non-standard
place, with lots of commentary on good practices and multi-platform

I want feedback on this on several axes:
  * Distutils terminology: eg. does "install-lib" mean what you think
    it should mean, or do you have a better idea?
  * Distutils semantics: eg. is the behaviour of "install-lib" sensible?
  * documentation organization
  * documentation wording
  * spelling, typos, typesetting, etc.

The docs are available at


Currently only LaTeX source and PDF available -- HTML soon.

Greg Ward - programmer-at-large                         gward@python.net
If it can't be expressed in figures, it is not science--it is opinion.