SIGs/KDE/Packaging/Cleanup

Macros

Current Macros

Currently, the macros for KDE packaging are basic and still need directories appended to them constantly for files in KDE packages. Here is a table of the current macros provided:

Macro	Definition	Path	Notes
%{_kde4_prefix}	%{_prefix}	/usr
%{_kde4_sysconfdir}	%{_sysconfdir}	/etc
%{_kde4_libdir}	%{_libdir}	/usr/lib[64]
%{_kde4_libexecdir}	%{_libexecdir}/kde4	/usr/libexec/kde4
%{_kde4_datadir}	%{_datadir}	/usr/share
%{_kde4_sharedir}	%{_datadir}	/usr/share	Why duplicate %{_kde4_datadir}?
%{_kde4_iconsdir}	%{_kde4_sharedir}/icons	/usr/share/icons
%{_kde4_configdir}	%{_kde4_sharedir}/config	/usr/share/config
%{_kde4_appsdir}	%{_kde4_sharedir}/kde4/apps	/usr/share/kde4/apps
%{_kde4_docdir}	/usr/share/doc	/usr/share/doc	Why is the definition not using a macro?
%{_kde4_bindir}	%{_kde4_prefix}/bin	/usr/bin	Not %{_bindir}?
%{_kde4_sbindir}	%{_kde4_prefix}/sbin	/usr/sbin	Not %{_sbindir}
%{_kde4_includedir}	%{_kde4_prefix}/include/kde4	/usr/include/kde4	Not %{_includedir}/kde4 ?

Proposed macros

There are many directories that appear over and over in packaging KDE applications and libraries.

Directory	Use	Proposed Macro	Urgency	Reason
%{_kde4_docdir}/HTML	HTML/API documentation	%{_kde4_htmldocdir}	medium	Used mostly for any HTML documentation
%{_kde4_datadir}/mime/packages	xdg shared-mime-info standard files	%{_kde4_mimedir}	high	Mimetype directory (xdg)
%{_kde4_datadir}/applications/kde4	.desktop files for applications	%{_kde4_desktopdir}	high	All applications need a .desktop file here (macro name could be better)
%{_kde4_configdir}.kcfg	KCFG files	%{_kde4_kcfgdir}	high	Most applications use KCFG for configuration
%{_kde4_libdir}/kde4	KPlugin libraries	%{_kde4_plugindir}	high	Directory for KPlugin libraries
%{_kde4_datadir}/kde4/services	services for KDE apps (plugin metadata)	%{_kde4_servicesdir}	high	Directory for KPlugin metadata
%{_kde4_datadir}/kde4/servicetypes	specs for types of services	%{_kde4_servicetypesdir}	high	Directory for KPlugin metadata
%{_kde4_datadir}/dbus-1/interfaces	DBus interface declarations	%{_kde4_dbusifacedir}	low	Used outside KDE as well
%{_kde4_datadir}/dbus-1/services	DBus services	%{_kde4_dbusservicedir}	low	Used outside KDE as well
%{_kde4_sysconfdir}/kde/env	scripts for user login/creation		low	Not used often
%{_kde4_sysconfdir}/kde/shutdown	scripts to run on user logout		low	Not used often
%{_kde4_appsdir}/kconf_update	kconf update scripts	%{_kde4_kconfdir}	low	Not used often; kconf is known to not work 100% anyways
%{_kde4_datadir}/autostart	session start .desktop files		low	Not used often
%{_kde4_datadir}/sounds	sounds (notifications)	%{_kde4_sounddir}	medium	Convenience; kde-look packages mainly
%{_kde4_datadir}/mimelnk	KDE3 mime data		low	KDE3; why do KDE4 apps still use this?
%{_kde4_datadir}/applnk	unused?		low	Looks mostly unused, delete it altogether?
%{_kde4_datadir}/emoticons	emoticon directory	%{_kde4_emoticondir}	medium	Convenience; kde-look packages mainly
%{_kde4_datadir}/templates	templates directory	%{_kde4_templatedir}	medium	Convenience; kde-look packages mainly

The old macros would become:

Macro	Definition
%{_kde4_prefix}	%{_prefix}
%{_kde4_sysconfdir}	%{_sysconfdir}
%{_kde4_libdir}	%{_libdir}
%{_kde4_libexecdir}	%{_libexecdir}/kde4
%{_kde4_datadir}	%{_datadir}
%{_kde4_iconsdir}	%{_kde4_datadir}/icons
%{_kde4_configdir}	%{_kde4_datadir}/config
%{_kde4_appsdir}	%{_kde4_datadir}/kde4/apps
%{_kde4_docdir}	%{_docdir}
%{_kde4_bindir}	%{_bindir}
%{_kde4_sbindir}	%{_sbindir}
%{_kde4_includedir}	%{_includedir}

This would bump the KDE macros API to 3 and force a rebuild of all KDE apps. I propose this is done before KDE 4.3 final hits.

Process

Here is how the migration could work (KDE-SIG approval pending)

• Include new macros in kde-filesystem
• File bugs against KDE4 packages to use new macros. Possible bug text:

Bug report text
The path macros have been updated so that common directories are macros. The new macros are at <https://fedoraproject.org/wiki/SIGs/KDE/PackagingCleanup#Macros>. Please update the spec file to use these new macros and close this bug when all stable branches are updated. If it is not done by <some date>, provenpackager access will be used to use the new macros so that the older macros may be dropped. Thank you for your cooperation.

• If no response by (some date TBD), use provenpackager to use new macros. (F13 alpha?)
• Remove old macros

Affected Packages and Status

Package	Maintainer	Bug filed	F-10	F-11	F-12	devel
kde-filesystem	KDE SIG
kdeaccessibility	KDE SIG
kdeadmin	KDE SIG
kdeartwork	KDE SIG
kdebase	KDE SIG
kdebase-runtime	KDE SIG
kdebase-workspace	KDE SIG
kdebindings	KDE SIG
kdeedu	KDE SIG
kdegames	KDE SIG
kdegraphics	KDE SIG
kdelibs	KDE SIG
kdelibs-experimental	KDE SIG
kdemultimedia	KDE SIG
kdenetwork	KDE SIG
kdepim	KDE SIG
kdepimlibs	KDE SIG
kdeplasma-addons	KDE SIG
kdesdk	KDE SIG
kde-settings	KDE SIG
kdetoys	KDE SIG
kdeutils	KDE SIG
amarok
audex
bespin
bibletime
bilbo
choqok
compiz
crystal
digikam
gnash	kkofler
gtk-qt-engine
kcoloredit
kcometen4
kdebluetooth
kde-plasma-ihatethecashew
kde-plasma-networkmanagement
kde-plasma-quickaccess
kde-plasma-runcommand
kde-plasma-stasks
kde-plasma-translatoid
kde-plasma-weather
kde-plasma-yawp
kde-style-skulpture
kdesvn
kdiff3
keurocalc
kgrab
kgtk
kiconedit
kid3
kio_sysinfo
kipi-plugins
KMess
kmid
kmplayer
knemo
kobby
konq-plugins
kopete-cryptography
kover
kpackagekit
kphotoalbum
kradio4
krusader
ksig
ksshaskpass
ktorrent
kvirc
kvkbd
mailody
PolicyKit-kde	obsolete
polyester
quarticurve-kwin-theme	kkofler
quassel
rekonq
rkward
rsibreak
sigen
skanlite
smb4k
subtitlecomposer
taglib-extras
yakuake

This list was generated with:

repoquery --whatrequires --alldeps --qf "%{sourcerpm}" kdelibs | sort | uniq

and under-review KDE4 apps added as well.