Quoting J G Miller (mil...@yoyo.org):
> Package: geneweb
> Version: 6.03-1
> Severity: normal
> 
> In the manual page for gwc it states
> 
>   The  primary  documentation  of gwc is in the HTML documentation, which
>   you can find in the documentation directory (/usr/share/doc/geneweb  on
>   Debian systems).
> 
>   Please look there for complete and up-to-date documentation.
> 
> This instruction is also repeated in the manual page for the other
> geneweb binaries consang, ged2gwb, gwb2ged, gwd, gwu.
> 
> However the directory /usr/share/doc/geneweb (or sub-directory thereof)
> contains no HTML files and a symbolic link to its-self
> 
>   0 lrwxrwxrwx    1 root root     23 2012-02-28 16:08 doc_choice -> 
> /usr/share/doc/geneweb//
> 
> The lack of documentation makes creation of the geneological databases
> for use by GeneWeb a severe hurdle for new users.
> 
> The manual page for gwc also states
> 
>   SEE ALSO
>        gwc2(1)
> 
> but there is no manual page for gwc2 (nor corresponding binary to use).
> 
> Please would you consider including HTML documentation with this package.

Upstream just reported that, as of now, the documentation has been
removed from the published source, because it is outdated.

The official documentation is now online at
http://opensource.geneanet.org/projects/geneweb/wiki/En_Home.

Upstream mentions that the documentation might be re-included in the
published sources when it is up-to-date.

So, indeed, these manpages should be rewritten. However, I'd prefer
just having a README-doc file in /usr/share/doc/geneweb that would
explain this situation instead of rewriting all manpages...which could
very well be a temporary situation only.


Attachment: signature.asc
Description: Digital signature

Reply via email to