/usr/share/doc/kde4 (Debian) vs. /usr/share/doc/kde (Kubuntu)

[Modestas Vainius]

Hello,

apparently, Debian and Kubuntu use different paths for HTML docs. Debian uses 
/usr/share/doc/kde4/HTML and Kubuntu uses /usr/share/doc/kde/HTML. I don't 
know why this did happen (I didn't care much about KDE 4 in its very early <= 
KDE 4.0.x days when it was unusable) though I would be very interested in 
hearing good reasons. My wild guess is /usr/share/doc/kde/HTML/en/common 
conflict with kdelibs-data (KDE 3)?.

Upstream default is yet another path (/usr/share/doc/HTML), which obviously is 
not a very good choice for Debian given how all packages use 
/usr/share/doc/<package>.

So obviously this difference does not make kubuntu people very happy because 
extra work is needed for merging packages from Debian. As far as I understand, 
they want Debian to switch. I also think that this difference in configuration 
could be avoided since there does not seem to be a good reason for it. So:

1) Which distro should switch and why? Make take on this is:
  a) as far as I understand, Kubuntu diverted from Debian on their own will 
sometime during KDE 4.{12} (please correct me if I'm wrong, I really don't 
know) and face consequences now;
  b) but we also pursue for s/kde4/kde/ where kde4 is pointless. AFAIK, 
/usr/share/doc/kde4/ brings no advantages to the table in comparison with 
/usr/share/doc/kde. What is more, /usr/share/doc/kde is more traditional as it 
was used by KDE 3 as well.

2) Now implications of Debian switch:
  a) it is late in the release cycle, RMs won't be very happy about it and may 
not even allow it when/if we ask;
  b) almost all affected packages (48 [ 30 excluding KDE SC]) will need 
maintainer uploads;
  c) majority of official KDE SC packages are affected (18 out of 23). So the 
only opportunity I see for this is KDE SC 4.4.4 release;
  d) if we do not do it for squeeze but for squeeze+1, we will complicate life 
for backporters;
  e) if we do it later, there will be more packages to fix;
  f) affected packages are mostly maintained by pkg-kde and pkg-kde-extras 
[1];
  g) we would need to solve one package conflict (kdelibs-data vs. kdelibs5-
data) for the switch and some changes to k3b-i18n will be needed [2];
  h) volunteers are needed for pulling this off. That is mass bug reporting, 
likely patch/NMU preparation (NMU sponsoring could be arranged if needed), 
tracking status. Personally, I do not volunteer.

1. $ grep usr/share/doc/kde4 Contents-amd64 | awk '{print $2}' | cut -d/ -f2 | 
sort | uniq | xargs dd-list --nou

M G Berberich <berberic at fmi.uni-passau.de>
   kcollectd

Regis Boudin <regis at debian.org>
   tellico

Debian KDE Extras Team <pkg-kde-extras at lists.alioth.debian.org>
   digikam-doc
   icecc-monitor
   k3b
   kcheckgmail
   kdesudo
   kdesvn
   keurocalc
   kile
   kmess
   kmplayer
   kmymoney
   konq-plugins
   konversation
   kphotoalbum
   krecipes
   krusader
   rsibreak
   skanlite
   skrooge
   smb4k

Debian Multimedia Maintainers <pkg-multimedia-
maintainers at lists.alioth.debian.org>
   kmidimon

Debian Qt/KDE Maintainers <debian-qt-kde at lists.debian.org>
   kde-l10n
   kde4libs
   kdeaccessibility
   kdeadmin
   kdebase
   kdebase-runtime
   kdebase-workspace
   kdeedu
   kdegames
   kdegraphics
   kdemultimedia
   kdenetwork
   kdepim
   kdepimlibs
   kdesdk
   kdetoys
   kdeutils
   kdewebdev

Thomas Friedrichsmeier <tfry at users.sourceforge.net>
   rkward

Debian QA Group <packages at qa.debian.org>
   kwave

Ryan Kavanagh <ryanakca at kubuntu.org>
   frescobaldi

Eike Sauer <eike at debian.org>
   kdiff3

Frank S. Thomas <fst at debian.org>
   eqonomize

Torsten Werner <twerner at debian.org>
   kvkbd

Jonathan Wiltshire <debian at jwiltshire.org.uk>
   backintime


2. Conflicting files after switch to /usr/share/doc/kde

usr/share/doc/kde4/HTML/en/common/artistic-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/bottom-left.png	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/bottom-middle.png	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/bottom-right.png	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/bsd-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/fdl-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/fdl-notice.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/gpl-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/kde-default.css	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/kde_logo_bg.png	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/lgpl-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/mainfooter.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/mainheader.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/qpl-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/top-middle.png	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/x11-license.html	    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/10.png		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/doxygen.css		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/favicon.ico		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/fdl-license		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/footer.html		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/gpl-license		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/header.html		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/lgpl-license		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/top-left.png		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/xml.dcl		    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/1.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/2.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/3.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/4.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/5.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/6.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/7.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/8.png			    libs/kdelibs5-data
usr/share/doc/kde4/HTML/en/common/9.png			    libs/kdelibs5-data
usr/share/doc/kde/HTML/en/common/artistic-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/bottom-left.png	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/bottom-middle.png	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/bottom-right.png	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/bsd-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/fdl-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/fdl-notice.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/gpl-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/kde-default.css	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/kde_logo_bg.png	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/lgpl-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/mainfooter.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/mainheader.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/qpl-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/x11-license.html	    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/doxygen.css		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/favicon.ico		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/fdl-license		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/footer.html		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/gpl-license		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/header.html		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/lgpl-license		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/top-left.png		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/top-middle.png		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/xml.dcl		    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/10.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/1.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/2.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/3.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/4.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/5.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/6.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/7.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/8.png			    libs/kdelibs-data
usr/share/doc/kde/HTML/en/common/9.png			    libs/kdelibs-data
usr/share/doc/kde4/HTML/de/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/es/k3b/burndialog_audio.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/burndialog_progress.png	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/es/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/cdcopy_reading.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/cdcopy_settings.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/cdcopy_writing.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/select_audiofiles.png	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/es/k3b/select_project.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/et/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/et/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/fr/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/fr/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/nl/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/nl/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt_BR/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/pt_BR/k3b/cdcopy-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/pt_BR/k3b/index.cache.bz2	    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/pt/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/sv/k3b/burndialog_audio.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/burndialog_progress.png	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/sv/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/cdcopy_reading.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/cdcopy_settings.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/cdcopy_writing.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/select_audiofiles.png	    localization/k3b-
i18n
usr/share/doc/kde4/HTML/sv/k3b/select_project.png	    localization/k3b-i18n
usr/share/doc/kde4/HTML/uk/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/de/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/audiocd-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/burndialog_audio.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/burndialog_progress.png	    localization/k3b-
i18n
usr/share/doc/kde/HTML/es/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/cdcopy_reading.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/cdcopy_settings.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/cdcopy_writing.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/select_audiofiles.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/select_project.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/et/k3b/audiocd-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/et/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/fr/k3b/audiocd-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/fr/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/nl/k3b/audiocd-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/nl/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/pt_BR/k3b/audiocd-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde/HTML/pt_BR/k3b/cdcopy-howto.docbook	    localization/k3b-
i18n
usr/share/doc/kde/HTML/pt_BR/k3b/index.cache.bz2	    localization/k3b-i18n
usr/share/doc/kde/HTML/pt/k3b/audiocd-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/pt/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/audiocd-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/burndialog_audio.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/burndialog_progress.png	    localization/k3b-
i18n
usr/share/doc/kde/HTML/sv/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/cdcopy_reading.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/cdcopy_settings.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/cdcopy_writing.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/select_audiofiles.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/select_project.png	    localization/k3b-i18n
usr/share/doc/kde/HTML/uk/k3b/cdcopy-howto.docbook	    localization/k3b-i18n
usr/share/doc/kde4/HTML/de/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/de/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/cdcopy_done.png		    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/et/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/et/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/fr/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/fr/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/nl/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/nl/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt_BR/k3b/common		    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt_BR/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/cdcopy_done.png		    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/uk/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/de/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/de/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/cdcopy_done.png		    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/et/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/et/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/fr/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/fr/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/nl/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/nl/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/pt_BR/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/pt/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/pt/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/cdcopy_done.png		    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/dcop.docbook		    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde/HTML/uk/k3b/index.cache.bz2		    localization/k3b-i18n
usr/share/doc/kde4/HTML/de/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/es/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/et/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/fr/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/nl/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/pt/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/sv/k3b/common			    localization/k3b-i18n
usr/share/doc/kde4/HTML/uk/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/de/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/es/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/et/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/fr/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/nl/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/pt_BR/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/pt/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/sv/k3b/common			    localization/k3b-i18n
usr/share/doc/kde/HTML/uk/k3b/common			    localization/k3b-i18n

-- 
Modestas Vainius <modestas at vainius.eu>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part.
URL: <http://lists.alioth.debian.org/pipermail/pkg-kde-talk/attachments/20100523/c9818683/attachment.pgp>