[ Please don't Cc: me when replying to my message on a mailing list. ]
Kai Henningsen:
> Maybe for people that like Emacs. Info has the same significantly less-
> than-intuitive user interface, so at least for me, man pages work far
> better as tutorials ... fighting with the interface *does* tend to
> distract from the text.
Since I think I managed not to break that one... info2www
is fairly good for browsing Info. You need a httpd and a web
browser, though. Making HTML from Texinfo with texi2html is
even better.
Debian packages should provide HTML versions of Info files
as well. Fortunately, this is pretty trivial. You need to
install texi2html and format the documentation using a command
such as
texi2html -split_node -expandinfo -menu -glossary -number <texinfo file>
And, of course, install the generated files somewhere below
/usr/doc/<package>. The options may need tweaking for different
documents.
One more thing: Add a file /usr/doc/<package>/.dwww-index, which
looks something like
#section general
<dt><a href="hello/hello.html">GNU Hello</a>
<dd>The Hello program greets the users. This is the GNU version of
this popular utility. (Really: This is an example package
that shows Debian developers how packages are created.)
Also add the following command to postinst and postrm:
if [ -x /usr/sbin/dwww-doc-index ]
then
/usr/sbin/dwww-doc-index
fi
This will create a long and a short index of documents for dwww.
If you don't run dwww-doc-index, then it will be run by dwww's
daily crontab entry, but it's better to do it at once.
(We'll get a working dwww soonish. The index stuff doesn't work
with the current version in unstable. The info2www stuff is not
directly a part of dwww, and it works fine.)
--
Please read <http://www.iki.fi/liw/mail-to-lasu.html> before mailing me.
Please don't Cc: me when replying to my message on a mailing list.
Attachment:
pgpaPOgbYdCV0.pgp
Description: PGP signature