pkg kde talk - Jan 2008 - What''s up -doc-html ?

For the KDE 3 packages, we built HTML versions of the handbook documentation 
for use with doc-base.  However, our KDE 4 packages currently do not build 
HTML documentation packages, with the exception of kdegames.  Is there a plan 
for HTML documentation in the KDE 4 packages?  If not, I can think of three 
possiblities:

1. Do not build any HTML documentation
	HTML documentation would only likely be used in a situation where KDE 
applications are installed, but the user cannot, or prefers not to, use 
khelpcenter.  Popcon stats report that approximately 450 participating 
machines even have these packages installed.  We could remove the HTML 
documentation package from kdegames too.  We could build HTML docs later if 
somebody complains.

2. Create -doc-html packages for each module
	Just like in the KDE 3 packages.

3. Put HTML documentation in each package
	Every application that includes a handbook would also inlcude the HTML 
version too.



I''m inclined towards #1, since I would assume that anyone who installs
KDE
apps will be using khelpcentre.  Thoughts?
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part.
Url :
http://lists.alioth.debian.org/pipermail/pkg-kde-talk/attachments/20080115/3eeecbdc/attachment.pgp

On Tue, 15 Jan 08 17:45, Matthew Rosewarne wrote:
> 1. Do not build any HTML documentation
> 	HTML documentation would only likely be used in a situation where KDE 
> applications are installed, but the user cannot, or prefers not to, use 
> khelpcenter.  Popcon stats report that approximately 450 participating 
> machines even have these packages installed.  We could remove the HTML 
> documentation package from kdegames too.  We could build HTML docs later if
> somebody complains.
+1
Personally I don''t see any usecase. Normally you view the documentation
via ''Help>Foo Handbook'' or something like this and you are
done.
If we really want html docs they can be enabled in CMake btw if I''m not
mistaken.
> 3. Put HTML documentation in each package
> 	Every application that includes a handbook would also inlcude the HTML 
> version too.
Please don''t do this. Why should all the people have the documentation
two times?

/Armin