the other day i wanted to use the help function of kile and discovered that documentation is not installed by default. In fact, i have tons of packages without documentation. While this may be a sensible default, i would like to have a convenient method of adding documentation to my installed programs.
Is there any way to do this in opensuse other than searching for every package for which i want documentation individually and installing the corresponding documentation package? Ideally, i would like a function in yast that displays all uninstalled documentation packages for packages which i have installed.
If there is no such function, where can i submit a request for its implementation or, failing that, sign up to contribute it myself?
where did you look for the Kile documentation? [sorry, your first post
here i can’t tell for certain you level of current openSUSE knowledge,
so pardon if you know all of this] i ask because most documentation is
normally default installed in or near:
/usr/share/doc
like maybe one of these (i’ve never installed kile so i don’t know):
or install locate (via yast) on your system and once its database is
updated you can command line issue
locate kile
and up would pop the path to all ‘kile’ on your drive…(and those
ending in either .txt or .html are probably what you look for, for
example point your browser at
file:///usr/share/doc/packages/bash/bash.html
if, in fact kile didn’t automatically/default install its
documentation into the /usr/share/doc tree (and if you installed kile
using YaST and an openSUSE repo) then we (someone) needs to find out
why the RPM doesn’t include docs (as is normal) and expected…
oh, i guess you already learned that F1 help is not so swift for
anything other than KDE and KDE applications…and maybe Gnome but i
never every use F1 “help” because i find it is often written by/for
Windows refugees . . .
let us know how you get on…and, for future reference the place to
submit a feature request around here is: http://en.opensuse.org/Fate
thanks for your thorough reply. I have looked at the problem again and found that the kile documentation is indeed there, but some links to it seem to be wrong.
For example, there is a “Tip of the Day” item about how you can click on a paragraph in a .dvi file and kile will automatically navigate there in the corresponding .tex file.
There is also a link to the documentation which promises more information about how to enable that feature. When you follow that link, however, konqueror opens and displays an error message:
Dateiname quick_inverseforward.html nicht auffindbar in file:///usr/share/doc/kde/HTML/en//kile/quick_inverseforward.html
In case you don’t speak german, this means “filename quick_inverseforward.html cannot be found in file:///usr/share/doc/kde/HTML/en//kile/quick_inverseforward.html”
The URL that is used to produce this message is
help:/kile/quick_inverseforward.html
This is how i initially stumbled upon this error. But i guess this is something that the kile developers have to worry about. Or could this be a packaging issue? (i don’t see how)
Again, thanks for your reply, i will post future feature requests (as far as they pertain to errors/annoyances that actually exist ) to the place you mentioned.
, i will post future feature requests (as
> far as they pertain to errors/annoyances that actually exist )
gotcha!
yeah, i don’t know if it is a packaging issue or a documentation
originator issue…to me it sounds like some one changed the name of a
page from quick_inverseforward.html to something else (maybe
quick_inverse_forward.html) and forgot to update all the embedded
links that point to it…
you didn’t say so i don’t know the best tool to suggest, but why don’t
you use konqueror or dolphin or midnight commander or firefox or opera
or lynx or or or to look around in /usr/share/doc/kde/HTML/en//kile/
and see if something similar to quick_inverseforward
quickinverseforward quick_inverse_forward exists there…