~ubuntu-branches/ubuntu/maverick/python3.1/maverick

« back to all changes in this revision

Viewing changes to debian/README.PVER.in

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2009-03-23 00:01:27 UTC
  • Revision ID: james.westby@ubuntu.com-20090323000127-mr2oo53y4j8vpldi
Tags: 3.1~a1+20090322-1
* Python 3.1 alpha1 release.
* Update to the trunk, 20090322.
* Update installation schemes: LP: #338395.
  - When the --prefix option is used for setup.py install, Use the
    `unix_prefix' scheme.
  - Use the `deb_system' scheme if --install-layout=deb is specified.
  - Use the the `unix_local' scheme if neither --install-layout=deb
    nor --prefix is specified.
* Use the information in /etc/lsb-release for platform.dist(). LP: #196526.
* pydoc: Fix detection of local documentation files.
* Build a shared library configured --with-pydebug. LP: #322580.
* Fix some lintian warnings.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
  Python @VER@ for Debian
 
3
  ---------------------
 
4
 
 
5
This is Python @VER@ packaged for Debian.
 
6
 
 
7
This document contains information specific to the Debian packages of
 
8
Python @VER@.
 
9
 
 
10
 
 
11
 
 
12
   [TODO: This document is not yet up-to-date with the packages.]
 
13
 
 
14
Currently, it features those two main topics:
 
15
 
 
16
  1. Release notes for the Debian packages:
 
17
  2. Notes for developers using the Debian Python packages:
 
18
 
 
19
Release notes and documentation from the upstream package are installed
 
20
in /usr/share/doc/@PVER@/.
 
21
 
 
22
There's a mailing list for discussion of issues related to Python on Debian
 
23
systems: debian-python@lists.debian.org. The list is not intended for
 
24
general Python problems, but as a forum for maintainers of Python-related
 
25
packages and interested third parties.
 
26
 
 
27
 
 
28
 
 
29
1. Release notes for the Debian packages:
 
30
 
 
31
 
 
32
Results of the regression test:
 
33
------------------------------
 
34
 
 
35
The package does successfully run the regression tests for all included
 
36
modules. Seven packages are skipped since they are platform-dependent and
 
37
can't be used with Linux.
 
38
 
 
39
 
 
40
2. Notes for developers using the Debian python packages:
 
41
 
 
42
See the draft of the Debian Python policy in /usr/share/doc/python.
 
43
 
 
44
distutils can be found in the @PVER@-dev package. Development files
 
45
like the python library or Makefiles can be found in the @PVER@-dev
 
46
package in /usr/lib/@PVER@/config. Therefore, if you need to install 
 
47
a pure python extension, you only need @PVER@. On the other hand, to 
 
48
install a C extension, you need @PVER@-dev.
 
49
 
 
50
a) Locally installed Python add-ons
 
51
 
 
52
    /usr/local/lib/@PVER@/site-packages/
 
53
    /usr/local/lib/site-python/ (version-independent modules)
 
54
 
 
55
b) Python add-ons packaged for Debian
 
56
 
 
57
    /usr/lib/@PVER@/site-packages/
 
58
    /usr/lib/site-python/ (version-independent modules)
 
59
 
 
60
Note that no package must install files directly into /usr/lib/@PVER@/
 
61
or /usr/local/lib/@PVER@/. Only the site-packages directory is allowed
 
62
for third-party extensions.
 
63
 
 
64
Use of the new `package' scheme is strongly encouraged. The `ni' interface
 
65
is obsolete in python 1.5.
 
66
 
 
67
Header files for extensions go into /usr/include/@PVER@/.
 
68
 
 
69
 
 
70
Installing extensions for local use only:
 
71
----------------------------------------
 
72
 
 
73
Consider using distutils ...
 
74
 
 
75
Most extensions use Python's Makefile.pre.in. Note that Makefile.pre.in
 
76
by default will install files into /usr/lib/, not into /usr/local/lib/,
 
77
which is not allowed for local extensions. You'll have to change the
 
78
Makefile accordingly. Most times, "make prefix=/usr/local install" will
 
79
work.
 
80
 
 
81
 
 
82
Packaging python extensions for Debian:
 
83
--------------------------------------
 
84
 
 
85
Maintainers of Python extension packages should read
 
86
 
 
87
        /usr/share/doc/python/python-policy.txt.gz
 
88
 
 
89
 
 
90
 
 
91
 
 
92
    03/09/98
 
93
    Gregor Hoffleit <flight@debian.org>
 
94
 
 
95
Last change: 2001-12-14