.TH PYTHON-MKDEBIAN "1" "May 2010" "python-mkdebian" "User Commands"

.SH NAME
python\-mkdebian \- Generate a suitable Debian source package for a standard distutils application

.SH SYNOPSIS
.B python\-mkdebian
[\fIoptions\fR]

.SH DESCRIPTION

This script generates a reasonably Debian Policy compliant Debian source
package for a Python application that uses distutils properly. It assumes that
there are no public Python modules, and generates just a single application
binary package.

Information is taken from setup.py's generated .egg-info file: author, project
name, description, version, upstream source, license, and required and provided
Python modules (which are translated to Debian python library package names,
and automatically added as package dependencies).

It generates a simple cdbs/python-support rules file.

.B python\-mkdebian
was designed to be used with the
.B DistUtilsExtra.auto
module, which calculates required Python dependencies automatically. However,
it makes no explicit assumptions about
.B DistUtilsExtra\fR,
so if
.B setup.py
has complete information it will work with any distutils setup.

.SH OPTIONS
.TP
\fB\-\-force\-control\fR=\fIFORCE_CONTROL\fR
Force control file behaviour. Can be one of "none" (keep unchanged), "deps"
(only update dependencies), or "full" (recreate whole file). By default
only dependencies will be updated ("deps").

.TP
\fB\-\-force\-copyright\fR
Force whole copyright file to be recreated. By default it will not touch an
already existing copyright file, so that you can customize them.

.TP
\fB\-\-force\-rules\fR
Force whole rules file to be recreated. By default it will not touch an
already existing rules file, so that you can customize them.

.TP
\fB\-\-changelog\fR=\fICHANGELOG\fR
Add changelog entry to debian/changelog (can be
specified multiple times)
.TP
\fB\-\-dependency\fR=\fIPACKAGENAME\fR
Add additional debian package dependency (can be
specified multiple times)
.TP
\fB\-\-prefix\fR=\fIPREFIX\fR
Ask for installing all your modules in the dedicated PREFIX (default is /usr)
.TP
\fB\-\-version\fR
Show program's version number and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
Show this help message and exit

.SH "SEE ALSO"
Python help for the distutils module

.SH AUTHOR
.B python\-mkdebian
is developed by Martin Pitt <martin.pitt@ubuntu.com>.