From 38e30d55f26ad93b8a516b11d646e9febb3ccc9e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Piotr=20O=C5=BCarowski?= <piotr@debian.org> Date: Thu, 5 Aug 2010 21:23:16 -0400 Subject: [PATCH] * Add manpage for dh_python2, pycompile and pyclean * Standards-Version bumped to 3.9.1 (no other changes required) --- debian/changelog | 2 ++ debian/control | 2 +- debian/control.in | 2 +- debian/python-minimal.manpages | 2 ++ debian/python.manpages | 1 + debian/rules | 1 + dh_python2 | 12 +++---- dh_python2.1 | 64 ++++++++++++++++++++++++++++++++++ pyclean.1 | 22 ++++++++++++ pycompile.1 | 41 ++++++++++++++++++++++ 10 files changed, 141 insertions(+), 8 deletions(-) create mode 100644 debian/python-minimal.manpages create mode 100644 debian/python.manpages create mode 100644 dh_python2.1 create mode 100644 pyclean.1 create mode 100644 pycompile.1 diff --git a/debian/changelog b/debian/changelog index c6f5730..1c93ee4 100644 --- a/debian/changelog +++ b/debian/changelog @@ -2,6 +2,8 @@ python-defaults (2.6.5-12) unstable; urgency=low * pycompile: do not hang if interpreters are not started in the same order as they're used (LP: #613675) + * Add manpage for dh_python2, pycompile and pyclean + * Standards-Version bumped to 3.9.1 (no other changes required) -- Piotr Ożarowski <piotr@debian.org> Thu, 05 Aug 2010 19:15:52 -0400 diff --git a/debian/control b/debian/control index 9fdccf7..fe9852c 100644 --- a/debian/control +++ b/debian/control @@ -5,7 +5,7 @@ Maintainer: Matthias Klose <doko@debian.org> Uploaders: Scott Kitterman <scott@kitterman.com>, Piotr Ożarowski <piotr@debian.org> Build-Depends: debhelper (>= 6.0.7~) Build-Depends-Indep: libhtml-tree-perl, debiandoc-sgml, python-docutils (>= 0.4-3) -Standards-Version: 3.9.0 +Standards-Version: 3.9.1 Homepage: http://www.python.org/ Vcs-Bzr: http://alioth.debian.org/anonscm/bzr/pkg-python/python-defaults-debian Vcs-Browser: http://alioth.debian.org/scm/loggerhead/pkg-python/python-defaults-debian/files diff --git a/debian/control.in b/debian/control.in index 37891db..6654c06 100644 --- a/debian/control.in +++ b/debian/control.in @@ -5,7 +5,7 @@ Maintainer: Matthias Klose <doko@debian.org> Uploaders: Scott Kitterman <scott@kitterman.com>, Piotr Ożarowski <piotr@debian.org> Build-Depends: debhelper (>= 6.0.7~) Build-Depends-Indep: libhtml-tree-perl, debiandoc-sgml, python-docutils (>= 0.4-3) -Standards-Version: 3.9.0 +Standards-Version: 3.9.1 Homepage: http://www.python.org/ Vcs-Bzr: http://alioth.debian.org/anonscm/bzr/pkg-python/python-defaults-debian Vcs-Browser: http://alioth.debian.org/scm/loggerhead/pkg-python/python-defaults-debian/files diff --git a/debian/python-minimal.manpages b/debian/python-minimal.manpages new file mode 100644 index 0000000..242b101 --- /dev/null +++ b/debian/python-minimal.manpages @@ -0,0 +1,2 @@ +pyclean.1 +pycompile.1 diff --git a/debian/python.manpages b/debian/python.manpages new file mode 100644 index 0000000..47df0aa --- /dev/null +++ b/debian/python.manpages @@ -0,0 +1 @@ +dh_python2.1 diff --git a/debian/rules b/debian/rules index 856860f..c885265 100755 --- a/debian/rules +++ b/debian/rules @@ -155,6 +155,7 @@ stamp-dh_python: binary-indep: build install stamp-doc dh_testdir -i dh_testroot -i + dh_installman -i : # provide the python and python.1 defaults mkdir -p debian/python-minimal/usr/bin diff --git a/dh_python2 b/dh_python2 index 0ad9181..e07c6ba 100755 --- a/dh_python2 +++ b/dh_python2 @@ -392,9 +392,9 @@ def main(): option_class=Option) parser.add_option('--no-guessing-versions', action='store_false', dest='guess_versions', default=True, - help='disables guessing other supported Python versions') + help='disable guessing other supported Python versions') parser.add_option('--no-guessing-deps', action='store_false', - dest='guess_deps', default=True, help='disables guessing dependencies') + dest='guess_deps', default=True, help='disable guessing dependencies') parser.add_option('--skip-private', action='store_true', dest='skip_private', default=False, help='don\'t check private directories') @@ -403,15 +403,15 @@ def main(): # arch=False->arch:all only, arch=True->arch:any only, None->all of them parser.add_option('-i', '--indep', action='store_false', dest='arch', default=None, - help='Act on architecture independent packages') + help='act on architecture independent packages') parser.add_option('-a', '--arch', action='store_true', - dest='arch', help='Act on architecture dependent packages') + dest='arch', help='act on architecture dependent packages') parser.add_option('-q', '--quiet', action='store_false', dest='verbose', default=True, help='be quiet') parser.add_option('-p', '--package', action='append', dest='package', - help='Act on the package named PACKAGE') + help='act on the package named PACKAGE') parser.add_option('-N', '--no-package', action='append', dest='no_package', - help='Do not act on the specified package') + help='do not act on the specified package') parser.add_option('-V', type='version_range', dest='vrange', help='specify list of supported Python versions. ' +\ 'See pycompile(1) for examples') diff --git a/dh_python2.1 b/dh_python2.1 new file mode 100644 index 0000000..f9169b8 --- /dev/null +++ b/dh_python2.1 @@ -0,0 +1,64 @@ +.TH DH_PYTHON2 "1" "August 2010" "dh_python2 2.0~beta1" "User Commands" +.SH NAME +dh_python2 \- calculates Python dependencies, adds maintainer scripts to byte compile files, etc. +.SH SYNOPSIS +.B dh_python2 +\fI-p PACKAGE \fR[\fI-V \fR[\fIX.Y\fR][\fI-\fR][\fIA.B\fR]] \fIDIR_OR_FILE \fR[\fI-X REGEXPR\fR] +.SH OPTIONS +.TP +\fB\-\-version\fR +show program's version number and exit +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-\-no\-guessing\-versions\fR +disable guessing other supported Python versions +.TP +\fB\-\-no\-guessing\-deps\fR +disable guessing dependencies +.TP +\fB\-\-skip\-private\fR +don't check private directories +.TP +\fB\-v\fR, \fB\-\-verbose\fR +turn verbose mode one +.TP +\fB\-i\fR, \fB\-\-indep\fR +act on architecture independent packages +.TP +\fB\-a\fR, \fB\-\-arch\fR +act on architecture dependent packages +.TP +\fB\-q\fR, \fB\-\-quiet\fR +be quiet +.TP +\fB\-p\fR PACKAGE, \fB\-\-package\fR=\fIPACKAGE\fR +act on the package named PACKAGE +.TP +\fB\-N\fR NO_PACKAGE, \fB\-\-no\-package\fR=\fINO_PACKAGE\fR +do not act on the specified package +.TP +\fB\-V\fR VRANGE +specify list of supported Python versions. See +pycompile(1) for examples +.TP +\fB\-X\fR REGEXPR, \fB\-\-exclude\fR=\fIREGEXPR\fR +exclude items that match given REGEXPR. You may use +this optionmultiple times to build up a list of things +to exclude. +.TP +\fB\-\-depends\fR=\fIDEPENDS\fR +translate given requirements into Debian dependencies +and add them to ${python:Depends}. Use it for missing +items in requires.txt. +.TP +\fB\-\-recommends\fR=\fIRECOMMENDS\fR +translate given requirements into Debian dependencies +and add them to ${python:Recommends} +.TP +\fB\-\-suggests\fR=\fISUGGESTS\fR +translate given requirements into Debian dependencies +and add them to ${python:Suggests} +.SH "SEE ALSO" +/usr/share/doc/python-doc/README.PyDist (python-doc package) diff --git a/pyclean.1 b/pyclean.1 new file mode 100644 index 0000000..2cdfdbb --- /dev/null +++ b/pyclean.1 @@ -0,0 +1,22 @@ +.TH PYCLEAN "1" "August 2010" "pyclean 0.9" "User Commands" +.SH NAME +pyclean \- removes .pyc and .pyo files +.SH SYNOPSIS +.B pyclean +[\fI-p PACKAGE | DIR_OR_FILE\fR] +.SH OPTIONS +.TP +\fB\-\-version\fR +show program's version number and exit +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-v\fR, \fB\-\-verbose\fR +turn verbose more one +.TP +\fB\-q\fR, \fB\-\-quiet\fR +be quiet +.TP +\fB\-p\fR PACKAGE, \fB\-\-package\fR=\fIPACKAGE\fR +specify Debian package name to clean diff --git a/pycompile.1 b/pycompile.1 new file mode 100644 index 0000000..c3e7908 --- /dev/null +++ b/pycompile.1 @@ -0,0 +1,41 @@ +.TH PYCOMPILE "1" "August 2010" "pycompile 0.9" "User Commands" +.SH NAME +pycompile \- byte compiles Python source files +.SH SYNOPSIS +.B pycompile +[\fI-V \fR[\fIX.Y\fR][\fI-\fR][\fIA.B\fR]] \fIDIR_OR_FILE \fR[\fI-X REGEXPR\fR] +.SH DESCRIPTION +.IP +pycompile \fB\-p\fR PACKAGE +.SH OPTIONS +.TP +\fB\-\-version\fR +show program's version number and exit +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-v\fR, \fB\-\-verbose\fR +turn verbose more one +.TP +\fB\-q\fR, \fB\-\-quiet\fR +be quiet +.TP +\fB\-p\fR PACKAGE, \fB\-\-package\fR=\fIPACKAGE\fR +specify Debian package name whose files should be +bytecompiled +.TP +\fB\-V\fR VRANGE +force private modules to be bytecompiled with Python +version from given range, regardless of the default +Python version in the system. If there are no other +options, bytecompile all public modules for installed +Python versions that match given range. VERSION_RANGE +examples: '2.5' (version 2.5 only), '2.5\-' (version +2.5 or newer), '2.5\-2.7' (version 2.5 or 2.6), '\-3.0' +(all supported 2.X versions) +.TP +\fB\-X\fR REGEXPR, \fB\-\-exclude\fR=\fIREGEXPR\fR +exclude items that match given REGEXPR. You may use +this option multiple times to build up a list of +things to exclude. -- GitLab