diff options
Diffstat (limited to 'doc/doc.txt')
-rw-r--r-- | doc/doc.txt | 22 |
1 files changed, 7 insertions, 15 deletions
diff --git a/doc/doc.txt b/doc/doc.txt index 1b2b5aa..6462a9b 100644 --- a/doc/doc.txt +++ b/doc/doc.txt @@ -20,25 +20,17 @@ syntax. .. _reStructuredText: http://docutils.sourceforge.net/docs/user/rst/quickref.html .. _NumPy/SciPy documentation guide: - http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines + https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt Man page ======== -The man-page source :file:`be.1.xml` is writen in DocBook 5 [#DB5]_ -format. The :file:`Makefile` converts it to :manpage:`roff(7)` format -using an XSLT stylesheet. See DocBook XSL [#DBXSL]_ for details. -See :doc:`install` for suggestions on setting up a DocBook 5 toolchain -in several distributions. +The man-page source :file:`be.1.txt` is writen in reStructuredText. +The :file:`Makefile` converts it to :manpage:`roff(7)` format using +Docutils_ ``rst2man``. The man page should conform to `Debian policy`_. -.. [#DB5] - See Norman Walsh's `DocBook 5: The Definitive Guide - <http://www.docbook.org/>`_ - -.. [#DBXSL] - See Bob Stayton's `DocBook XSL: The Complete Guide - <http://www.sagehill.net/book-description.html>`_ - -.. _Debian policy: http://www.debian.org/doc/debian-policy/ch-docs.html#s12.1 +.. _Docutils: http://docutils.sourceforge.net/ +.. _Debian policy: + http://www.debian.org/doc/debian-policy/ch-docs.html |