[Python-apps-commits] r6647 - in packages/cython/trunk/debian (4 files)

[yoh at users.alioth.debian.org]

    Date: Monday, February 14, 2011 @ 21:03:44
  Author: yoh
Revision: 6647

Use help2man to generate a reasonable manpage (Closes: #607098)

Modified:
  packages/cython/trunk/debian/changelog
  packages/cython/trunk/debian/control
  packages/cython/trunk/debian/rules
Deleted:
  packages/cython/trunk/debian/cython.1

Modified: packages/cython/trunk/debian/changelog
===================================================================
--- packages/cython/trunk/debian/changelog	2011-02-14 21:03:20 UTC (rev 6646)
+++ packages/cython/trunk/debian/changelog	2011-02-14 21:03:44 UTC (rev 6647)
@@ -4,6 +4,7 @@
   * Fresh upstream release
   * debian/control: added python-dev into Suggests (Closes: #545809)
   * Standards-Version bumped to 3.9.1 (no change needed)
+  * Use help2man to generate a reasonable manpage (Closes: #607098)
 
  -- Yaroslav Halchenko <debian at onerussian.com>  Sun, 13 Feb 2011 09:41:12 -0500
 

Modified: packages/cython/trunk/debian/control
===================================================================
--- packages/cython/trunk/debian/control	2011-02-14 21:03:20 UTC (rev 6646)
+++ packages/cython/trunk/debian/control	2011-02-14 21:03:44 UTC (rev 6647)
@@ -3,7 +3,7 @@
 Priority: optional
 Maintainer: Python Applications Packaging Team <python-apps-team at lists.alioth.debian.org>
 Uploaders: Ondrej Certik <ondrej at certik.cz>, Yaroslav Halchenko <debian at onerussian.com>
-Build-Depends: cdbs (>= 0.4.49), debhelper (>= 5.0.38), python (>= 2.4.4-6), python-all-dev (>= 2.4.4-6), python-support (>= 0.7.5), python-all-dbg
+Build-Depends: cdbs (>= 0.4.49), debhelper (>= 5.0.38), python (>= 2.4.4-6), python-all-dev (>= 2.4.4-6), python-support (>= 0.7.5), python-all-dbg, help2man (>= 1.37.1~)
 Standards-Version: 3.9.1
 Homepage: http://cython.org/
 Vcs-Svn: svn://svn.debian.org/svn/python-apps/packages/cython/trunk

Deleted: packages/cython/trunk/debian/cython.1
===================================================================
--- packages/cython/trunk/debian/cython.1	2011-02-14 21:03:20 UTC (rev 6646)
+++ packages/cython/trunk/debian/cython.1	2011-02-14 21:03:44 UTC (rev 6647)
@@ -1,44 +0,0 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH CYTHON 1 "November 30, 2007"
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh        disable hyphenation
-.\" .hy        enable hyphenation
-.\" .ad l      left justify
-.\" .ad b      justify to both left and right margins
-.\" .nf        disable filling
-.\" .fi        enable filling
-.\" .br        insert line break
-.\" .sp <n>    insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.SH NAME
-cython \- compile python-like .pyx file to C for use as python module
-.SH SYNOPSIS
-.B cython
-.RI " files" ...
-.SH DESCRIPTION
-This manual page documents briefly the
-.B cython
-command.
-This manual page was written for the Debian distribution
-because the original program does not have a manual page.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
-.\" respectively.
-\fBcython\fP is a python script that converts a .pyx file to C, so it can
-be compiled for use as a Python module.
-.PP
-You then need to compile the .c file along with the include files for
-Python, and link it into a shared library.
-.PP
-The HTML documentation explains this better, and the Demo examples show how
-to automate the compile and link stages more easily. 
-.SH AUTHOR
-This manual page was written by Peter Harris <scav at blueyonder.co.uk>, for the
-Debian GNU/Linux system (but may be used by others) and the pyrex package.
-Modified by Ondrej Certik <ondrej at certik.cz> for the Cython package.

Modified: packages/cython/trunk/debian/rules
===================================================================
--- packages/cython/trunk/debian/rules	2011-02-14 21:03:20 UTC (rev 6646)
+++ packages/cython/trunk/debian/rules	2011-02-14 21:03:44 UTC (rev 6647)
@@ -14,8 +14,8 @@
 include /usr/share/cdbs/1/rules/debhelper.mk
 include /usr/share/cdbs/1/class/python-distutils.mk
 
-install/cython:: assure-changelogs
-	dh_installman debian/cython.1
+install/cython:: assure-changelogs build/cython.1
+	dh_installman build/cython.1
 
 
 #
@@ -36,6 +36,16 @@
 	mkdir -p debian/cython-dbg/usr/share/doc
 	ln -s cython debian/cython-dbg/usr/share/doc/cython-dbg
 
+
+build/cython.1: build
+	: # Generate a manpage using help2man
+	PYTHONPATH="$(shell /bin/ls -d $(CURDIR)/build/lib.*-$(cdbs_python_current_version) 2>&1)" \
+	  help2man --no-info --no-discard-stderr \
+		-n "compile Cython code (.pyx) into C to build a Python extension" \
+		bin/cython >| build/cython.1
+	: # Verify that manpage generated nicely -- no Errors reported
+	grep -q 'ImportError:' build/cython.1 && exit 1 || :
+
 # To fetch and update upstream Changelogs
 # Notes:
 #  SED is used to do minor de-wikification to make text readable