Description of problem:
Documentation in KDE Help Center is missing.
Steps to reproduce:
1. Install Mageia 1
2. go to "configure your desktop"
3. hit F1
4. Try viewing documentation for anything besides manpages.
I expected to see documentation.
documentation was missing.
Thought: if documentation is going to be trimmed, there should be a special package to easily install it again; perhaps this should be part of the standard install/upgrade process.
Edit: for this to work, I think you have to install from CD; I have a feeling DVDs supply the full documentation (I know this is the case with Mandriva).
What did you expect as documentation ? (aka which part is missing)
In mdv the application Handbooks (the files that go in /usr/share/doc/HTML) were stripped out for the live CD's, to save space. I assume that the same has been done in mga.
As James says, I was referring to the application handbooks.
The workaround is reinstalling the package(s) in question, this time the packages, with all the docs, will be downloaded from the online repositories, e.g. to get the handbook of kopete:
urpmi --replacepkgs kopete
Should we split the handbooks from all packages ?
(aka having a kopete package & a kopete-handbooks as suggested ) ?
I did not know that thoses files where removed from the live-cd.
IINM, in the Live image the rpms are installed with --excludedocs, or something like that.
There is a bug report in mdv bugzilla about the same topic, it didn't go any where though https://qa.mandriva.com/show_bug.cgi?id=31639
I'm pretty sure you are correct; --excludedocs would do exactly what is done here. Thanks for the nice workaround.
Of course, not everyone needs the handbooks, but that decision should be the user's. Documentation is pretty important; without it, people can't "RTFM."
splitting the handbooks is certainly an interesting idea.
Splitting the handbooks from every kde package would cause a lot of clutter, too many sub-packages, and since they can't be on the live CD due to space constraints, users will have to install them manually...
Maybe all the handbooks from each KDE .src.rpm can be in one single sub-package, e.g. kdebase4-handbooks, kdebase4-workspace-handbooks... etc; however this being a viable option depends on how big that -handbooks package will be, if it's too big, then a user who just wants the handbook of konsole, wouldn't want to download a big package when the konsole handbook is a small portion of it. (My initial guess is that they would be small in size, since ultimately they're just text files..).
Of course this doesn't fix the issue distro-wide, just for kde packages (which is still an improvement IMHO).
WRT size: some handbooks are quite heavily illustrated. Anyway, besides text files there are pictures, too.
@ennael ? what should we do ?
Ennael is agree with this change, however i'll do it only for the next mageia release (so we should be ok for at least KDE SC 4.7.1 in cauldron )
Changing as per discussion (best chance to get a fix in '2')
RPM Packages =>
Release (media or process)Hardware:
well it's already fixed for mageia 2 :)