Re: strange behavior of dh_dhelp

[Roland Rosenfeld <roland@spinnaker.de>]

Marco Budde <mbudde@sms.antar.com> wrote:

> Why? What is the advantage of using doc-base?

You may want to read the documentation of doc-base...
It is always a good idea to use a generic format which can
automatically converted to all useful formats instead of using one
special format.  doc-base gives us the chance to add some other
documentation system next to dwww and dhelp (both are horribly broken
at the moment, so another one may be a good idea) without changing all 
the packages.

If you think, that install-docs is too slow and dhelp-parse in
combination with dhelp2dwww.pl is so much faster, why don't you simply 
rewrite install-docs in C?  Then we have a generic and fast solution.

> P.S.: The latest dhelp 0.3.14 supports FHS *and* FSSTND :).

I just installed it, but as far as I can see this doesn't integrate
FHS and FSSTND in any way but creates two completely incompatible
trees one next to the other.  Now I can read parts of the
documentation as http://localhost/doc/ (which points to /usr/doc/) and
others as http://localhost/fhs/ (which points to /usr/share/doc/).
But I would prefer these two trees to be merged.  This should be
possible for most packages, because the tech-ctte decided that every
package that uses /usr/share/doc/<pkg> has to create a symlink
/usr/doc/<pkg> pointing to /usr/share/doc/<pkg>.  So all documentation
should be available as /usr/doc/<pkg>.  The only problem is, that
dhelp doesn't support those links at the moment.  My packages which
follow the tech-ctte decision (using debhelper and dh_installdocs) are
only visible in http://localhost/fhs/HTML/ but not in
http://localhost/doc/HTML/.

In the past we had two places where the user had to look for
documentation on programs: http://localhost/doc/HTML/ and
http://localhost/dwww/menu.html 

You new version of dhelp splits this to three places:
http://localhost/doc/HTML/, http://localhost/fhs/HTML/ and
http://localhost/dwww/menu.html and all three include different doc,
see for example section graphics:

- Sketch User's Guide           dhelp/FHS              dwww
- Sketch Developer's Guide                             dwww
- Imlib Programmer's Guide      dhelp/FHS              dwww
- XFIG User Manual              dhelp/FHS              dwww
- TIFF Software                           dhelp/FSSTND
- pstoedit                                dhelp/FSSTND

Tschoeeee

        Roland

-- 
 * roland@spinnaker.de * http://www.spinnaker.de/ *
 PGP: 1024/DD08DD6D   2D E7 CC DE D5 8D 78 BE  3C A0 A4 F1 4B 09 CE AF