Whole document tree
What's dhelp?dhelp is an online help system for Debian GNU/Linux. A Debian package can register its HTML documents and dhelp builds an index of all documents. The user doesn't need a WWW server to browse the HTML tree.
How to use dhelpIf you have installed a WWW server on your system simply browse
If you haven't installed a WWW server use the dhelp command:
The .dhelp filePrograms supporting dhelp have to install a .dhelp file in every directory under /usr/share/doc. For every HTML file that should appear in the dhelp index the .dhelp file have to contain the following section:
You can have only one tag per line! Something like the following will not work:
<item><directory>de/foo <dirtitle>The foo section <linkname>foo <filename>foo.html <descrip>foo foo foo</descrip></item>You have to use this:
<item> <directory>de/foo <dirtitle>The foo section <linkname>foo <filename>foo.html <descrip> foo foo foo </descrip> </item>You can have several <item> sections in one .dhelp file.
Add a .dhelp file to the indexTo add a .dhelp file to the document index you have to call dhelp_parse:
# dhelp_parse -a /usr/share/doc/directoryI would suggest to add the following to your package postinst script:
if [ -f /usr/sbin/dhelp_parse ]; then /usr/sbin/dhelp_parse -a /usr/share/doc/directory fi
In prerm you should use:
if [ -f /usr/sbin/dhelp_parse ]; then /usr/sbin/dhelp_parse -d /usr/share/doc/directory fi
Or you can use the script dh_dhelp. This script installs the debian/dhelp file in /usr/share/doc/package and creates the postinst and prerm scripts of all .dhelp files found in /usr/share/doc.
Scripts for .dhelp file
sgml2dhelpIf the HTML files were produced by the sgml-tools (linuxdoc-sgml) you can use the script sgml2dhelp.pl. This script produces a .dhelp, a .dwww-index, and a index.html file.
Run this script in every directory containing HTML files. You have to call the script with to options:
sgml2dhelp <dhelp section> <dwww section>If your documents should go in the German HOWTO section for example, you have to enter:
# dhelp.build de/HOWTO general
dhelp2dwwwIf you have written a .dhelp, you can convert it to a .dwww-index file with the script dhelp2dwww.pl.
dhelp2dwww <dwww section>
What can I do for dhelp?If you like dhelp please ask maintainers of Debian packages including HTML documentation to add dhelp support.
If you have any comments or problems please feel free to send an email to the dhelp package maintainer: firstname.lastname@example.org