On Thursday 18 August 2005 20.57, John R. Sowden wrote: > I am starting to play with kommander, a kde gui front end to, it seems > anything. I was referred to it by the fellows at the linuxworld/san > francisco kde booth. Hi John, > 1) The doc files are in /opt/kde3/share/doc/end/html, if I got that right. > In that directory are .png files (graphics) and .docbook files, which > appear to be xml text files. when using firefox to look at them, I get the > following error: > XML Parsing Error: undefined entity > Location: file:///opt/kde3/share/doc/HTML/en/kommander/credits.docbook > Line Number 23, Column 12:<title>The &kommander; Development Team</title> > -----------^ > > am I (sorry, my ego is too inflated to use lower case to refer to myself in > the first person. please accept the fact that I am not shouting) supposed > to have a separate driver/plug in/whatever to allow firefox to read xml > files? > > 2. How does commander know for which shell it is writing script? > > 3. there are more, but I am saving them up . . . Here's the rundown on how the docs really work. During compilation, a program called meinproc (which is part of kdelibs) processes the *.docbook files into an index.cache.bz2 file (which is a cache of the prerendered HTML in a bzip2'ed tarball) - if you installed a package, this was probably done for you. When you type help:/kommander in a konqueror window, or find the Kommander help in KHelpCenter or for most applications, choose Help -> <appname> Handbook, the index.cache.bz2 is used to quickly display the manual if possible. If not possible (for instance, the docbook file is newer than the cache) then the *.docbook files are rendered on the fly to html (and that is cached in your user cache so it doesn't have to happen again.) For meinproc to work, you need to have kdelibs compiled with bzip2, libxslt, and libxml2 - if you installed packages, make sure that any mentioning doctools or helpcenter are installed, they should have been built with these dependencies in place. You should not have any *.html files there, I don't know why other posters do, perhaps a packaging error (they are not used in any case.) Regards, -- Lauri Watts KDE Documentation: http://docs.kde.org KDE on FreeBSD: http://freebsd.kde.org
Attachment:
pgpBb2DI42xj0.pgp
Description: PGP signature
___________________________________________________ . Account management: https://mail.kde.org/mailman/listinfo/kde. Archives: http://lists.kde.org/. More info: http://www.kde.org/faq.html.
