diff options
Diffstat (limited to 'doc/doc.txt')
| -rw-r--r-- | doc/doc.txt | 20 |
1 files changed, 6 insertions, 14 deletions
diff --git a/doc/doc.txt b/doc/doc.txt index 1b2b5aa..e57b1f7 100644 --- a/doc/doc.txt +++ b/doc/doc.txt @@ -25,20 +25,12 @@ syntax. 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 |