Marco Budde <[EMAIL PROTECTED]> 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 -- * [EMAIL PROTECTED] * http://www.spinnaker.de/ * PGP: 1024/DD08DD6D 2D E7 CC DE D5 8D 78 BE 3C A0 A4 F1 4B 09 CE AF