On Tue, Jan 11, 2011 at 10:57:33AM +1100, Ben Finney wrote: > Why is there a dependency on xsltproc, and why is Docutils and Sphinx > insufficient?
I imagine you had reasons for writing the original manpage in DocBook SGML (vs. using groff macros directly) when you wrote the original version of the man page source. I just upgraded to the XML-based BocBook 5 (in commit 8c9f876ae69f7bf92686edea320931d875b5c681), since the DocBook stylesheets and XML processor seemed to be more consistently packaged than DocBook 4 SGML processors (docbook-to-man, docbook2man, ...). Besides, XML is the way the DocBook folks are headed. Of course, we could also use Docutils. It looks like they've included a manpage formatter (rst2man) since release 0.6 (October 2009). Docutils can build man pages from reStructuredText, and we could go that way instead. I just converted the man page, Makefile, and docs for this approach. Pull my repo to take a look. > What is “numpydoc”? That doesn't even seem to be in Debian. (It's not > the same thing as ‘python-numpy-doc’, AFAICT). What need has the Bugs > Everywhere documentation for anything to do with NumPy? numpydoc is a Sphinx extension originally developed for the Numpy/Scipy project that attempts to balance docstrings for Sphinx (i.e. lots of markup) with docstrings for interactive Python sessions (i.e. clean text), See https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt for the syntax that Numpy suggests. I don't know why Debian doesn't package the extension. It's been on PyPI for a while: http://pypi.python.org/pypi/numpydoc/0.2 http://pypi.python.org/pypi/numpydoc/0.3.1 http://pypi.python.org/pypi/numpydoc/0.4 Gentoo packages it as dev-python/numpydoc in the science overlay. http://overlays.gentoo.org/proj/science -- This email may be signed or encrypted with GPG (http://www.gnupg.org). The GPG signature (if present) will be attached as 'signature.asc'. For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy My public key is at http://www.physics.drexel.edu/~wking/pubkey.txt
pgpv3NzqvXK55.pgp
Description: PGP signature
_______________________________________________ Be-devel mailing list [email protected] http://void.printf.net/cgi-bin/mailman/listinfo/be-devel
