kommander issues

[Lauri Watts]

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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde/attachments/20050817/0e1718cd/attachment.sig>
-------------- next part --------------
___________________________________________________
This message is from the kde mailing list.
Account management:  https://mail.kde.org/mailman/listinfo/kde.
Archives: http://lists.kde.org/.
More info: http://www.kde.org/faq.html.