[Python-checkins] CVS: distutils README.txt,1.9,1.10
Greg Ward
python-dev@python.org
Tue, 11 Apr 2000 17:17:01 -0400 (EDT)
Update of /projects/cvsroot/distutils
In directory thrak:/home/gward/python/distutils
Modified Files:
README.txt
Log Message:
More updates 'n additions for 0.8.
Index: README.txt
===================================================================
RCS file: /projects/cvsroot/distutils/README.txt,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -r1.9 -r1.10
*** README.txt 2000/04/10 00:02:01 1.9
--- README.txt 2000/04/11 21:16:56 1.10
***************
*** 1,5 ****
Python Distutils
release 0.8
! April ??, 2000
--- 1,5 ----
Python Distutils
release 0.8
! April 11, 2000
***************
*** 18,26 ****
primarily so that you can add the Distutils to a Python 1.5.2
installation -- you will then be able to install modules that require
! the Distutils, or use the Distutils to distribute your own modules. The
! code in release 0.8 is a little more recent than the version of the
! Distutils that was included with Python 1.6a1, though, so if you like
! running the absolute latest version, you can add this to a Python 1.6
! installation -- see "INSTALLING UNDER PYTHON 1.6" below for information.
More information is available at the Distutils web page:
--- 18,22 ----
primarily so that you can add the Distutils to a Python 1.5.2
installation -- you will then be able to install modules that require
! the Distutils, or use the Distutils to distribute your own modules.
More information is available at the Distutils web page:
***************
*** 47,57 ****
Release 0.8 of the Distutils requires Python 1.5.2 or later.
! (Compatibility with Python 1.5.1 is forthcoming.)
! Under Unix, you must have a *complete* Python installation, including
! the Makefile and config.h used to build Python. These should be in
! <exec-prefix>/lib/python1.X/config (where <exec-prefix> is the value of
! the --exec-prefix option to Python's configure script, by default
! "/usr/local").
Certain Linux distributions break Python up into multiple packages; you
--- 43,57 ----
Release 0.8 of the Distutils requires Python 1.5.2 or later.
! (Compatibility with Python 1.5.1 is forthcoming, as soon as I merge the
! 1.5.1 compatibility changes from Distutils 0.1.4 and 0.1.5 forward.)
! To use the Distutils under Unix, you must have a *complete* Python
! installation, including the Makefile and config.h used to build Python.
! These should be in <exec-prefix>/lib/python1.X/config. (<exec-prefix>
! is the value of the --exec-prefix option to Python's configure script,
! or the --prefix option if --exec-prefix wasn't supplied; if neither was
! supplied, the default is "/usr/local". If you don't know your
! <exec-prefix>, fire up the Python interpreter and type
! "import sys ; sys.exec_prefix".)
Certain Linux distributions break Python up into multiple packages; you
***************
*** 59,65 ****
Red Hat python, python-devel
! SuSE ???
! Mandrake ???
! Debian ???
--- 59,65 ----
Red Hat python, python-devel
! Mandrake python, python-devel
! SuSE python
! Debian python-base, python-dev
***************
*** 68,72 ****
Obviously, in order to use the Distutils you must first install them.
! Luckily, since the goal of the whole project is to make distributing and
installing Python module distributions painless, this is quite easy:
--- 68,72 ----
Obviously, in order to use the Distutils you must first install them.
! Since the goal of the whole project is to make distributing and
installing Python module distributions painless, this is quite easy:
***************
*** 91,99 ****
-------------------------------
! Since Python 1.6 comes with the Distutils already installed, you'll need
! to "hide" the original Distutils package directory from Python, so it
! will find the version you install. For example, under a typical Unix
! installation, the "stock" Distutils directory is
! /usr/local/lib/python1.6-/distutils; you could hide this from Python as
follows:
--- 91,107 ----
-------------------------------
! The Distutils are included with Python 1.6, so there's generally no need
! to install it under Python 1.6. In fact, Distutils 0.8 is exactly the
! code included with Python 1.6a2, so there's certainly no need to install
! it under Python 1.6a2.
!
! However, while Python is progressing towards 1.6 final, and the
! Distutils are progressing towards 1.0, there's no guarantee that
! releases will proceed together -- sometimes, you'll want to upgrade the
! Distutils in your alpha/beta Python installation to the very latest. To
! do this, you'll need to hide the original Distutils package directory
! from Python, so it will find the version you install. For example,
! under a typical Unix installation, the "stock" Distutils directory is
! /usr/local/lib/python1.6/distutils; you could hide this from Python as
follows:
***************
*** 101,108 ****
mv distutils distutils-orig
! Under Windows, the stock Distutils installation is "Lib\distutils" under
! the Python directory ("C:\Program Files\Python" for Python 1.6a1,
! "C:\Python" for 1.6a2 and later). Again, you should just rename this
! directory, eg. to "distutils-orig", so that Python won't find it.
Once you have renamed the stock Distutils directory, you can install the
--- 109,116 ----
mv distutils distutils-orig
! On Windows, the stock Distutils installation is "Lib\distutils" under
! the Python directory ("C:\Python" by default for Python 1.6a2 and
! later). Again, you should just rename this directory, eg. to
! "distutils-orig", so that Python won't find it.
Once you have renamed the stock Distutils directory, you can install the
***************
*** 124,130 ****
Python Modules" (for developers and packagers). I've included the LaTeX
source for these two manuals in the "doc" subdirectory; if you know your
! way around the Python documentation tools, you can probably get
! something out of these. Otherwise, you're better off getting the latest
! documentation from the Distutils documentation page:
http://www.python.org/sigs/distutils-sig/doc/
--- 132,138 ----
Python Modules" (for developers and packagers). I've included the LaTeX
source for these two manuals in the "doc" subdirectory; if you know your
! way around LaTeX and the Python documentation tools, you can probably
! get something out of these. Otherwise, you're better off getting the
! latest documentation from the Distutils documentation page:
http://www.python.org/sigs/distutils-sig/doc/
***************
*** 167,172 ****
--- 175,182 ----
* rename the setup.py provided with Numerical Python 15.2, eg. to
"setup.py.orig"
+
* copy "examples/numpy_setup.py" into the Numerical Python source
tree as "setup.py"
+
* run "python setup.py install" for Numerical Python as usual
***************
*** 176,180 ****
For developers who need to convert their own module distributions to use
! the Distutils, I've included a couple of example setup scripts in the
"examples" subdirectory. Two of these (numpy_setup.py and xml_setup.py)
are already in production use -- in fact, xml_setup.py was stolen from
--- 186,190 ----
For developers who need to convert their own module distributions to use
! the Distutils, I've included several example setup scripts in the
"examples" subdirectory. Two of these (numpy_setup.py and xml_setup.py)
are already in production use -- in fact, xml_setup.py was stolen from
***************
*** 186,195 ****
If you want to try one of the example setup scripts in the real world,
you'll obviously have to have the appropriate module distribution
! available: Imaging-1.0 for "pil_setup.py", mxDateTime-1.3.0 for
! "mxdatetime_setup.py". All you have to do is:
* copy (or link) the provided setup script to "setup.py" in the
target distribution (eg. copy "examples/pil_setup.py" to "setup.py"
! in Imaging-1.0, wherever you unpacked the Imaging tarball)
* run the setup script:
--- 196,207 ----
If you want to try one of the example setup scripts in the real world,
you'll obviously have to have the appropriate module distribution
! available: Numerical-15.2 (numpy_setup.py), PyXML-0.5.3 (xml_setup.py),
! Imaging-1.0 (pil_setup.py), or mxDateTime-1.3.0 (mxdatetime_setup.py).
! All you have to do is:
* copy (or link) the provided setup script to "setup.py" in the
target distribution (eg. copy "examples/pil_setup.py" to "setup.py"
! in Imaging-1.0, wherever you unpacked the Imaging source
! distribution)
* run the setup script:
***************
*** 248,255 ****
--- 260,273 ----
* Mac OS support only partially included
* no test suite (hmm, is this testing thing a common theme?)
+
+ There are some major features that still need to be added:
+
* no configuration file mechanism (although it's talked about
in the documentation)
* no support for probing the target system for either C- or Python-
level dependencies
+ * no support for running test suites
+ * no support for processing documentation (and no standard
+ documentation format for Python modules!)
If you think of any limitations that aren't on the above list, or find
***************
*** 271,277 ****
1.0.1 or 1.0.2 or so.)
- I hope to address all of the above limitiations *except* for probing the
- taret system for dependencies in the Distutils 0.8/0.9/1.0 series.
-
CONTRIBUTING
--- 289,292 ----
***************
*** 332,334 ****
the CPAN archive (Jarkko), and the CPAN module (Andreas)
! $Id: README.txt,v 1.9 2000/04/10 00:02:01 gward Exp $
--- 347,349 ----
the CPAN archive (Jarkko), and the CPAN module (Andreas)
! $Id: README.txt,v 1.10 2000/04/11 21:16:56 gward Exp $