[Python-modules-commits] r17791 - in packages/sphinx/trunk/debian (6 files)

[jwilk at users.alioth.debian.org]

    Date: Sunday, July 10, 2011 @ 12:29:16
  Author: jwilk
Revision: 17791

dh_sphinxdoc: add (a sprout of) a manpage.

Modified:
  packages/sphinx/trunk/debian/changelog
  packages/sphinx/trunk/debian/clean
  packages/sphinx/trunk/debian/control
  packages/sphinx/trunk/debian/dh-sphinxdoc/dh_sphinxdoc
  packages/sphinx/trunk/debian/python-sphinx.manpages
  packages/sphinx/trunk/debian/rules

Modified: packages/sphinx/trunk/debian/changelog
===================================================================
--- packages/sphinx/trunk/debian/changelog	2011-07-10 11:38:19 UTC (rev 17790)
+++ packages/sphinx/trunk/debian/changelog	2011-07-10 12:29:16 UTC (rev 17791)
@@ -19,6 +19,8 @@
     documentation in Debian packages.
     + Update debian/rules, debian/control and debian/*.links to use
       dh_sphinxdoc.
+    + Use pod2man to generate manpage. Add dependency on perl. Update
+      debian/manpages and debian/clean.
   * Move all JavaScript code into a separate package, libjs-sphinxdoc.
   * Fix test_build_latex to not fail in a directory with special characters.
   * Use debian/clean rather than listing files to clean directly in

Modified: packages/sphinx/trunk/debian/clean
===================================================================
--- packages/sphinx/trunk/debian/clean	2011-07-10 11:38:19 UTC (rev 17790)
+++ packages/sphinx/trunk/debian/clean	2011-07-10 12:29:16 UTC (rev 17791)
@@ -1,3 +1,4 @@
+debian/dh-sphinxdoc/*.1
 sphinx/pycode/*.pickle
 sphinx/themes/basic/static/jquery.js
 sphinx/themes/basic/static/underscore.js

Modified: packages/sphinx/trunk/debian/control
===================================================================
--- packages/sphinx/trunk/debian/control	2011-07-10 11:38:19 UTC (rev 17790)
+++ packages/sphinx/trunk/debian/control	2011-07-10 12:29:16 UTC (rev 17791)
@@ -8,7 +8,8 @@
 Build-Depends-Indep: python-support (>= 0.6.4), python-docutils, python-pygments (>= 0.8), python-jinja2 (>= 2.1),
   python-nose, python (>= 2.6.6-14~) | python-simplejson,
   xvfb, xauth, python-webkit, libjs-jquery (>= 1.4), libjs-underscore,
-  texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended
+  texlive-latex-recommended, texlive-latex-extra, texlive-fonts-recommended,
+  perl
 Standards-Version: 3.9.2
 Vcs-Svn: svn://svn.debian.org/python-modules/packages/sphinx/trunk/
 Vcs-Browser: http://svn.debian.org/viewsvn/python-modules/packages/sphinx/trunk/

Modified: packages/sphinx/trunk/debian/dh-sphinxdoc/dh_sphinxdoc
===================================================================
--- packages/sphinx/trunk/debian/dh-sphinxdoc/dh_sphinxdoc	2011-07-10 11:38:19 UTC (rev 17790)
+++ packages/sphinx/trunk/debian/dh-sphinxdoc/dh_sphinxdoc	2011-07-10 12:29:16 UTC (rev 17791)
@@ -25,6 +25,29 @@
 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+=head1 NAME
+
+dh_sphinxdoc - helps with packaging Sphinx-generated documentation
+
+=head1 SYNOPSIS
+
+dh_sphinxdoc [S<I<debhelper options>>] [B<-X>I<item>] [I<directory>...]
+
+=head1 DESCRIPTION
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-X>I<item>, B<--exclude=>I<item>
+
+Exclude files that contain I<item> anywhere in their filename from
+being symlinked, removed or checked for existence.
+
+=back
+
+=cut
+
 use strict;
 use warnings;
 
@@ -294,4 +317,16 @@
     }
 }
 
+=head1 SEE ALSO
+
+L<debhelper(7)>, L<dh(1)>.
+
+This program is meant to be used together with debhelper.
+
+=head1 AUTHOR
+
+Jakub Wilk <jwilk at debian.org>
+
+=cut
+
 # vim:ts=4 sw=4 et

Modified: packages/sphinx/trunk/debian/python-sphinx.manpages
===================================================================
--- packages/sphinx/trunk/debian/python-sphinx.manpages	2011-07-10 11:38:19 UTC (rev 17790)
+++ packages/sphinx/trunk/debian/python-sphinx.manpages	2011-07-10 12:29:16 UTC (rev 17791)
@@ -1,3 +1,4 @@
 debian/sphinx-build.1
 debian/sphinx-quickstart.1
 debian/sphinx-autogen.1
+debian/dh-sphinxdoc/dh_sphinxdoc.1

Modified: packages/sphinx/trunk/debian/rules
===================================================================
--- packages/sphinx/trunk/debian/rules	2011-07-10 11:38:19 UTC (rev 17790)
+++ packages/sphinx/trunk/debian/rules	2011-07-10 12:29:16 UTC (rev 17791)
@@ -74,6 +74,7 @@
 		mv $$js debian/libjs-sphinxdoc/$(javascript_path); \
 		ln -sf "$(javascript_path)/$${js##*/}" $$js; \
 	done
+	cd debian/dh-sphinxdoc/ && pod2man -c Debhelper -r '' dh_sphinxdoc dh_sphinxdoc.1
 
 binary-indep: build install
 	dh_testdir