Re: [carlos.borroto@gmail.com: [SCM] tophat branch, oneiric-ppa, updated. oneiric-ppa/1.4.0-1_oneiric3-3-g3edf06d]
On Sun, Feb 05, 2012 at 03:04:44PM -0500, Carlos Borroto wrote:
> On Sun, Feb 5, 2012 at 2:45 PM, Andreas Tille <andreas@an3as.eu> wrote:
> > Hi,
> >
> > just tell us if this package can be regarded as ready for uploading into
> > unstable.
> >
> > Thanks for working on this
> >
> > Andreas.
>
> Hi Andreas,
>
> Is only missing manpages. I talked to Alexandre about it and it seems
> we would have to use something like help2man. Upstream doesn't
> includes any manpage.
>
> Do you think the package can be uploaded without manpages?
There are certainly packages without a manpage inside Debian. While we
at least try to provide some and help2man makes this to a 10-15min task
we should keep the focus on our users. If you think users are better
served with the package in any case even if we do not manage to get
manpages written, we could upload it without. However, I can not really
see a reason why writting at least a basic manpage should be a hard
task.
> If not,
> I'll try to find the time this week to work on it. There is a long
> list of manpages to write:
> $ dpkg -L tophat | grep /usr/bin/
> /usr/bin/extract_reads
> ...
> /usr/bin/bam2fastx
Ahh, that's certainly a lot and stretches my estimation given above.
There are packages which are assembling the documentation for different
binaries in one manpage and place according symlinks. I do not want to
propose "cheating lintian", but there might be cases when this approach
makes perfectly sense. Just do whatever you consider serving your users
best. It also might be sufficient to document the main two or three
binaries with manpages and leave the lintian warnings for later as
reminder and just write one manpage per future upload. Just trust your
common sense what might be the proper way to go.
Kind regards and thanks for working on this
Andreas.
--
http://fam-tille.de
Reply to: