~ubuntu-branches/ubuntu/natty/debhelper/natty

« back to all changes in this revision

Viewing changes to dh_python

  • Committer: Bazaar Package Importer
  • Author(s): Joey Hess, Joey Hess, Valery Perrin
  • Date: 2011-02-05 12:00:04 UTC
  • mto: This revision was merged to the branch mainline in revision 66.
  • Revision ID: james.westby@ubuntu.com-20110205120004-9ayvm0q0xe2yl0hx
Tags: 8.1.0
[ Joey Hess ]
* python_distutils: Pass --force to setup.py build, to ensure that when
  python-dbg is run it does not win and result in scripts having it in
  the shebang line. Closes: #589759
* Man page fixes about what program -u passes params to. Closes: #593342
* Avoid open fd 5 or 6 breaking buildsystem test suite. Closes: #596679
* Large update to Spanish man page translations by Omar Campagne.
  Closes: #600913
* dh_installdeb: Support debian/package.maintscript files,
  which can contain dpkg-maintscript-helper commands. This can be used
  to automate moving or removing conffiles, or anything added to
  dpkg-maintscript-helper later on. Closes: #574443
  (Thanks, Colin Watson)
* Massive man page typography patch. Closes: #600883
  (Thanks, David Prévot)
* Explicitly build-depend on a new enough perl-base. Closes: #601188
* dh: Inhibit logging when an override target runs the overridden command,
  to avoid unexpected behavior if the command succeeded but the overall
  target fails. Closes: #601037
* Fix deprecated command list on translated debhelper(7) man pages.
  Closes: #601204
* dh: Improve filtering in dh_listpackages example. Closes: #604561
* dh: Add support for build-arch, build-indep, install-arch and
  install-indep sequences. Closes: #604563
  (Thanks, Roger Leigh)
* dh_listpackages: Do not display warnings if options cause no packages
  to be listed.
* dh_installdocs: Clarify that debian/README.Debian and debian/TODO are
  only installed into the first package listed in debian/control.
  Closes: #606036
* dh_compress: Javascript files are not compressed, as these go with
  (uncompressed) html files. Closes: #603553
* dh_compress: Ignore objects.inv files, generated by Sphinx documentation.
  Closes: #608907
* dh_installinit: never call init scripts directly, only through invoke-rc.d
  Closes: #610340
  (Thanks, Steve Langasek)

[ Valery Perrin ]
* update french translation.
* Fix french misspelling.
* French translation update after massive man page typography 

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
 
3
3
=head1 NAME
4
4
 
5
 
dh_python - calculates python dependencies and adds postinst and prerm python scripts (deprecated)
 
5
dh_python - calculates Python dependencies and adds postinst and prerm Python scripts (deprecated)
6
6
 
7
7
=cut
8
8
 
12
12
 
13
13
=head1 SYNOPSIS
14
14
 
15
 
B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] [S<I<module dirs ...>>]
 
15
B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] [S<I<module dirs> ...>]
16
16
 
17
17
=head1 DESCRIPTION
18
18
 
19
 
Note: This program is deprecated. You should use dh_pysupport or
20
 
dh_pycentral instead. This program will do nothing if debian/pycompat
21
 
or a Python-Version control file field exists.
22
 
 
23
 
dh_python is a debhelper program that is responsible for generating the
24
 
${python:Depends} substitutions and adding them to substvars files. It
25
 
will also add a postinst and a prerm script if required.
26
 
 
27
 
The program will look at python scripts and modules in your package, and
28
 
will use this information to generate a dependency on python, with the
29
 
current major version, or on pythonX.Y if your scripts or modules need a
30
 
specific python version. The dependency will be substituted into your
31
 
package's control file wherever you place the token "${python:Depends}".
 
19
Note: This program is deprecated. You should use B<dh_pysupport> or
 
20
B<dh_pycentral> instead. This program will do nothing if F<debian/pycompat>
 
21
or a B<Python-Version> F<control> file field exists.
 
22
 
 
23
B<dh_python> is a debhelper program that is responsible for generating the
 
24
B<${python:Depends}> substitutions and adding them to substvars files. It
 
25
will also add a F<postinst> and a F<prerm> script if required.
 
26
 
 
27
The program will look at Python scripts and modules in your package, and
 
28
will use this information to generate a dependency on B<python>, with the
 
29
current major version, or on B<python>I<X>B<.>I<Y> if your scripts or modules need a
 
30
specific B<python> version. The dependency will be substituted into your
 
31
package's F<control> file wherever you place the token B<${python:Depends}>.
32
32
 
33
33
If some modules need to be byte-compiled at install time, appropriate
34
 
postinst and prerm scripts will be generated. If already byte-compiled
 
34
F<postinst> and F<prerm> scripts will be generated. If already byte-compiled
35
35
modules are found, they are removed.
36
36
 
37
 
If you use this program, your package should build-depend on python.
 
37
If you use this program, your package should build-depend on B<python>.
38
38
 
39
39
=head1 OPTIONS
40
40
 
42
42
 
43
43
=item I<module dirs>
44
44
 
45
 
If your package installs python modules in non-standard directories, you
46
 
can make dh_python check those directories by passing their names on the
47
 
command line. By default, it will check /usr/lib/site-python,
48
 
/usr/lib/$PACKAGE, /usr/share/$PACKAGE, /usr/lib/games/$PACKAGE,
49
 
/usr/share/games/$PACKAGE and /usr/lib/python?.?/site-packages.
 
45
If your package installs Python modules in non-standard directories, you
 
46
can make F<dh_python> check those directories by passing their names on the
 
47
command line. By default, it will check F</usr/lib/site-python,
 
48
/usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>,
 
49
F</usr/share/games/$PACKAGE> and F</usr/lib/python?.?/site-packages>.
50
50
 
51
 
Note: only /usr/lib/site-python, /usr/lib/python?.?/site-packages and the
52
 
extra names on the command line are searched for binary (.so) modules.
 
51
Note: only F</usr/lib/site-python>, F</usr/lib/python?.?/site-packages> and the
 
52
extra names on the command line are searched for binary (F<.so>) modules.
53
53
 
54
54
=item B<-V> I<version>
55
55
 
56
 
If the .py files your package ships are meant to be used by a specific
57
 
pythonX.Y version, you can use this option to specify the desired version,
58
 
such as 2.3. Do not use if you ship modules in /usr/lib/site-python.
 
56
If the F<.py> files your package ships are meant to be used by a specific
 
57
B<python>I<X>B<.>I<Y> version, you can use this option to specify the desired version,
 
58
such as B<2.3>. Do not use if you ship modules in F</usr/lib/site-python>.
59
59
 
60
60
=item B<-n>, B<--noscripts>
61
61
 
62
 
Do not modify postinst/postrm scripts.
 
62
Do not modify F<postinst>/F<postrm> scripts.
63
63
 
64
64
=back
65
65