[Pkg-ltsp-devel] man pages

[Petter Reinholdtsen]

[Vagrant Cascadian]
> i put a little work into getting some man pages for the ltsp
> packages, and asciidoc seems the simplest choice to me (though
> requires a backport for sarge- though backports.org asciidoc works
> fine).

I would recommend maintaining the manual pages as nroff documents.
Are you aware of the manedit program?  I use it all the time to
maintain manual pages, as I am almost completely clueless about nroff
notation.

> this would require adding a build-depends on asciidoc (>= 7.0.0) and
> xmlto, which pulls in a fair bit of extra stuff.

I would like to avoid it.  If you really want to maintain the master
document as something else than the manpage format, I suggest adding
rules to the Makefile to generate the nroff document on requests, and
store the the generated file in bzr.