debian: Prepare for Debian upload

.gitignore

@@ -14,3 +14,6 @@ dh_virtualenv.egg-info/
 
 # Sphinx build
 doc/_build
+
+# Generated man page
+doc/dh_virtualenv.1

debian/changelog

@@ -1,13 +1,5 @@
-dh-virtualenv (0.6) unstable; urgency=low
+dh-virtualenv (0.6-1) unstable; urgency=low
 
-  * Fix lintian errors
-  * Support setuptools
-  * Support newer version of debhelper
+  * Closes: #727620
 
- -- Jyrki Pulliainen <[email protected]>  Fri, 25 Oct 2013 18:17:59 +0200
-
-dh-virtualenv (0.5-1) unstable; urgency=low
-
-  * Initial public release
-
- -- Jyrki Pulliainen <[email protected]>  Wed, 09 Oct 2013 17:18:09 +0200
+ -- Jyrki Pulliainen <[email protected]>  Fri, 10 Jan 2014 16:33:30 +0100

debian/compat

@@ -1 +1 @@
-8
+9

debian/control

@@ -1,15 +1,17 @@
 Source: dh-virtualenv
-Section: net
+Section: python
 Priority: extra
 Maintainer: Jyrki Pulliainen <[email protected]>
-Build-Depends: debhelper (>= 8), python(>= 2.6.6-3~),
- python-setuptools, python-sphinx (>= 1.0.8), python-mock
-Standards-Version: 3.9.4
+Build-Depends: debhelper (>= 9), python(>= 2.6.6-3~),
+ python-setuptools, python-sphinx, python-mock
+Standards-Version: 3.9.5
+Homepage: http://www.github.com/spotify/dh-virtualenv
 X-Python-Version: >= 2.6
 
 Package: dh-virtualenv
 Architecture: all
-Depends: ${python:Depends}, ${misc:Depends}, python-virtualenv (>= 1.7)
-Description: Wrap & build python packages using virtualenv
+Depends: ${python:Depends}, ${misc:Depends},  ${sphinxdoc:Depends},
+ python-virtualenv (>= 1.7)
+Description: wrap and build python packages using virtualenv
  This package provides a dh sequencer that helps you to deploy your
  virtualenv wrapped installation inside a Debian package.

debian/copyright

@@ -6,4 +6,23 @@ Source: http://www.github.com/spotify/dh-virtualenv
 Files: *
 Copyright: 2013 Spotify AB
 License: GPL-2+
- Full license available at /usr/share/common-licenses/GPL-2
+  Copyright (C) 2013 Spotify AB
+  .
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+  .
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+  .
+  You should have received a copy of the GNU General Public License along
+  with this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+  .
+  Comment:
+  .
+  On a Debian system you can find a copy of this license in
+  /usr/share/common-licenses/GPL-2.

debian/dh-virtualenv.doc-base

@@ -0,0 +1,9 @@
+Document: dh-virtualenv
+Title: dh-virtualenv documentation
+Author: Spotify
+Abstract: This manual describes dh-virtualenv and how to use it.
+Section: Programming
+
+Format: HTML
+Index: /usr/share/doc/dh-virtualenv/html/index.html
+Files: /usr/share/doc/dh-virtualenv/html/*.html

debian/dh-virtualenv.manpages

@@ -0,0 +1 @@
+doc/dh_virtualenv.1

debian/rules

@@ -1,7 +1,11 @@
 #!/usr/bin/make -f
 
 %:
-	dh $@ --with python2
+	dh $@ --with python2 --with sphinxdoc
+
+override_dh_auto_build:
+	rst2man doc/dh_virtualenv.1.rst > doc/dh_virtualenv.1
+	dh_auto_build
 
 override_dh_installdocs:
 	python setup.py build_sphinx

debian/source/format

@@ -0,0 +1 @@
+3.0 (quilt)

debian/watch

@@ -0,0 +1,3 @@
+version=3
+opts=filenamemangle=s/.+\/v?(\d\S*)\.tar\.gz/dh-virtualenv-$1.tar.gz/ \
+  https://github.com/spotify/dh-virtualenv/releases .*/v?(\d\S*)\.tar\.gz

doc/dh_virtualenv.1.rst

@@ -0,0 +1,65 @@
+=============
+dh-virtualenv
+=============
+
+------------------------------------------------------
+deploy a Python package in a self-contained virtualenv
+------------------------------------------------------
+
+:Author: Jyrki Pulliainen / Spotify AB <[email protected]>
+:Copyright: Copyright (C) 2013, Spotify AB. Licensed under
+    the GNU General Public License version 2 or later
+:Manual section: 1
+:Manual group: DebHelper
+
+SYNOPSIS
+========
+
+**dh-virtualenv** [*OPTIONS*]
+
+
+DESCRIPTION
+===========
+
+``dh-virtualenv`` is a tool that aims to combine Debian packaging with
+self-contained virtualenv based Python deployments. To do this, the
+package extends debhelper's sequence by providing a new command in
+sequence, ``dh_virtualenv``, which effectively replaces following
+commands from the sequence:
+
+ * ``dh_auto_install``
+ * ``dh_python2``
+ * ``dh_pycentral``
+ * ``dh_pysupport``
+
+In the sequence the ``dh_virtualenv`` is inserted right after
+``dh_perl``.
+
+OPTIONS
+=======
+
+-p PACKAGE, --package=PACKAGE		Act on the package named PACKAGE
+-N PACKAGE, --no-package=PACKAGE	Do not act on the specified PACKAGE
+-v, --verbose				Turn on verbose mode.
+--extra-index-url			Pass extra index URL to pip
+--preinstall=PACKAGE			Preinstall a PACKAGE before
+					running pip.
+--pypi-url				Base URL for PyPI server.
+--setuptools				Use setuptools instead of
+					distribute.
+
+QUICK GUIDE FOR MAINTAINERS
+===========================
+
+1. Build depend on `python` or `python-all` and `dh-virtualenv`
+2. Add `${python:Depends}` to Depends
+3. Add `python-virtualenv` to dh's `--with` option
+
+SEE ALSO
+========
+
+Online documentation can be found at
+http://dh-virtualenv.readthedocs.org/en/latest.
+
+This package should also ship with documentation under
+`/usr/share/doc/dh-virtualenv`.