[Pkg-emboss-devel] Bug#423938: Bug#423938: Manpages missing - source misses emboss.manpages or `dh_installman debian/manpages/*'

[Daniel Leidert]

severity 423938 wishlist
retitle 423938 Please ship manpages
thanks

Am Dienstag, den 15.05.2007, 11:02 +0900 schrieb Charles Plessy:
> Le Tue, May 15, 2007 at 03:33:15AM +0200, Daniel Leidert a écrit :
> > 
> > The emboss package doesn't include the manpages you seem to have (and
> > you seem to try to install in debian/rules). The manpages directory is
> > AFAIK not automatically registered (this might be a nice feature of
> > dh_installman) as manpage location. So you have two choices: (1) create
> > emboss.manpages with content
> > 
> > debian/manpages/*
> > 
> > or (2) specify this location at the command line in debian/rules.
> 
> Dear Daniel,
> 
> I think that unfortunately EMBOSS does not provide manpages. The ones
> you saw are copies from the UNDOCUMENTED (7) manpage, leftover from the
> preliminary work of Matt Hope. We will remove them soon.

Ah, ok. Didn't know that. I saw debian/rules and it seemed to me, that
you want to install some manpages.

> However,
> auto-generating manpages from the doc is definitely in our TODO list.
> EMBOSS will not leave experimental without manpages.
> 
> EMBOSS programs are written in AJAX Command Definition files (this has
> nothing to do with Web2.0) and I will try to parse these ACD files to
> generate the manpages (A parser is included in the emboss-explorer
> pacakges, which is under preparation). Do you think that it would make
> sense to generate intermediary DocBook files, or to directly generate
> nroff files?

I think, it doesn't make sense to generate DocBook files here. To
generate well formatted DocBook refentries, you need some really custom
thing, that parses the source code and you would most probably have to
write it yourself. So I guess it's easier to directly create roff. It's
simply one step less and you already have such a parser (even an
experimental one). No need to re-invent the wheel (although a parser
creating DocBook might be an interesting project):)

Regards, Daniel