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