Frameworks/Epics/KDEUI Crumble

KDEUI Crumble

This page is the battle plan to finally get rid of KDEUI in kdelibs/frameworks. It lists the header name of all the classes in kdeui, they are sorted in sections per new destination for them.

Each section tries to also provide simple indications of the contraints to follow during the move (mostly about dependencies). If a class is not fitting one of the constraints, it is part of the job to first reduce the dependencies of the class to fit the contraints prior to the move. If you are too blocked to carry on, please add a note for the class.

The sections are roughly sorted by order of difficulty. The classes in the first sections should be reasonably easy to move, while the ones in the last sections are more challenging.

KDE4Support

Points to verify before moving the class in KDE4Support:

• Make sure the class is used only in kde4support itself or kde4attic but not anywhere else in kdelibs
• Don't forget to change the export in the moved header
• Add API doc in the header file about it being deprecated and indicate how to port

Status	Description	Notes	Contact
DONE	./fonts/kfontdialog.h deprecated for QFontDialog	Anne-Marie Mahfouf	<[email protected]>
IN PROGRESS	./fonts/kfontcombobox.h deprecated for QFontComboBox	David Edmundson	<[email protected]>
IN PROGRESS	./dialogs/kinputdialog.h deprecated for QInputDialog	David Gil	<[email protected]>
TODO	./dialogs/kdeprintdialog.h (should be done by Qt, kcups* goes with it)	...	<[email protected]>
IN PROGRESS	./widgets/keditlistbox.h deprecated for KEditListWidget	Review 110464	<[email protected]>
TODO	./widgets/kstringvalidator.h only the zombie kfilemetainfowidget uses it	...	<[email protected]>
IN PROGRESS	./widgets/ktabbar.h deprecated for QTabBar	Review 110460	<[email protected]>
DONE	./widgets/ktabwidget.h deprecated for QTabWidget	...	<[email protected]>
IN PROGRESS	./widgets/kbuttongroup.h Use real QGroupBox and QButtonGroup instances please, kthxbye	Review 110478	<[email protected]>
IN PROGRESS	./widgets/knuminput.h Use real QSpinBox	Review 110418. Waiting for Qt5 to be updated to include Kevin's base patch	<[email protected]>
DONE	./widgets/ktextbrowser.h deprecated for QTextBrowser	Anne-Marie Mahfouf	<[email protected]>
TODO	./util/kpixmapcache.h deprecated for KImageCache or KSharedDataCache	...	<[email protected]>
TODO	./util/kaccelgen.h	...	<[email protected]>
TODO	./actions/ktoolbarspaceraction.h	...	<[email protected]>

KDE4Attic

Points to verify before moving the class in KDE4Attic [[1]]:

• Make sure the class is not used anywhere in kdelibs anymore

Status	Description	Notes	Contact
DONE	./widgets/kdatetimeedit.h	https://git.reviewboard.kde.org/r/110415/	<[email protected]>
IN PROGRESS	./widgets/kdatepicker.h	...	<[email protected]>
TODO	./widgets/kmultitabbar.h (used by kate, digikam, kexi --- but could use a cleanup, see e.g. KDEV3ICON...)	...	<[email protected]>
DONE	./widgets/kdatecombobox.h	http://git.reviewboard.kde.org/r/110447/	<[email protected]>
IN PROGRESS	./widgets/ktimezonewidget.h	http://git.reviewboard.kde.org/r/110451/	<[email protected]>
IN PROGRESS	./widgets/kdatetimewidget.h	https://git.reviewboard.kde.org/r/110457/	<[email protected]>
TODO	./widgets/kcharselect.h Can soon go into kwidgetsaddons (needs clear button in QLineEdit)	...	<[email protected]>
IN PROGRESS	./widgets/kdatewidget.h	wait for kdatetimewidget to move first	<[email protected]>
IN PROGRESS	./widgets/ktimecombobox.h	review 110477	<[email protected]>
TODO	./widgets/klanguagebutton.h	...	<[email protected]>
TODO	./widgets/kdatetable.h	...	<[email protected]>
TODO	./util/kpassivepopupmessagehandler.h only user is kde-runtime/knotify. Move it there?	...	<[email protected]>
TODO	./shortcuts/kgesture.h use #if 0 for the code in xmlgui (KShortcutsEditor) that uses KGesture (it's already hidden from the user anyway)	...	<[email protected]>
TODO	./shortcuts/kgesturemap.h needs polish before it can be resurrected	...	<[email protected]>

KGuiAddons

Points to verify before moving a class in KGuiAddons:

• It depends only on QtGui or QtCore, eventually QX11Info

Status	Description	Notes	Contact
TODO	./util/kmodifierkeyinfo.h	...	<[email protected]>
TODO	./fonts/kfontutils.h	...	<[email protected]>
TODO	./util/kimagecache.h but but but... KsharedDataCache is in kcoreaddons :-/ (tough problem)	...	<[email protected]>

KWidgetsAddons

Points to verify before moving a class in KWidgetsAddons:

• It depends only on QtWidgets, QtGui or QtCore
• It can depend on other classes in KWidgetsAddons, but that should be kept minimal

Status	Description	Notes	Contact
DONE	./fonts/kfontrequester.h	...	<[email protected]>
TODO	./dialogs/kassistantdialog.h	...	<[email protected]>
TODO	./dialogs/kpixmapregionselectordialog.h	...	<[email protected]>
TODO	./dialogs/klinkdialog.h	...	<[email protected]>
IN PROGRESS	./dialogs/knewpassworddialog.h	...	<[email protected]>
IN PROGRESS	./dialogs/kpassworddialog.h	...	<[email protected]>
TODO	./widgets/kpixmapregionselectorwidget.h	...	<[email protected]>
TODO	./widgets/ktitlewidget.h	...	<[email protected]>
TODO	./widgets/kratingwidget.h	...	<[email protected]>
TODO	./widgets/kratingpainter.h	...	<[email protected]>
TODO	./widgets/kmessagewidget.h (Needs to get rid of K* using fixed default colors, Qstyle :styleHint and Qstyle :standardPixmap)	...	<[email protected]>
TODO	./widgets/keditlistwidget.h	...	<[email protected]>
TODO	./widgets/kactionselector.h	...	<[email protected]>
TODO	./util/kpassivepopup.h	...	<[email protected]>
TODO	./util/kcursor.h	...	<[email protected]>
TODO	./paged/kpagewidget.h	...	<[email protected]>
TODO	./paged/kpagedialog.h	...	<[email protected]>
TODO	./paged/kpageview.h	...	<[email protected]>
TODO	./paged/kpagemodel.h	...	<[email protected]>
TODO	./paged/kpagewidgetmodel.h	...	<[email protected]>
TODO	./shortcuts/kacceleratormanager.h the list of translated texts from standard actions will have to be set by the first KStandardAction being constructed	...	<[email protected]>
TODO	./colors/kcolorbutton.h minor duplication of KcolorMimeData though	...	<[email protected]>
TODO	./colors/kcolorcombo.h	...	<[email protected]>
TODO	./actions/kactionmenu.h	...	<[email protected]>
TODO	./actions/ktoolbarlabelaction.h	...	<[email protected]>
TODO	./actions/ktoolbarpopupaction.h	...	<[email protected]>

KWindowSystem

Points to verify before moving a class in KWindowSystem:

• It depends only on QtWidgets, QtGui or QtCore
• It can depend on other classes in KWindowSystem, but that should be kept minimal

Status	Description	Notes	Contact
TODO	./util/kkeyserver_x11.h	...	<[email protected]>
TODO	./util/kxerrorhandler.h	...	<[email protected]>
TODO	./util/kkeyserver_win.h	...	<[email protected]>
TODO	./util/kkeyserver_mac.h	...	<[email protected]>
TODO	./util/kkeyserver.h	...	<[email protected]>

KWidgets

Points to verify before moving a class in KWidgets:

• It doesn't use anything aimed at KCompletion (e.g. KLineEdit or KComboBox)
• It doesn't use anything aimed at ItemViews
• It doesn't use anything from kdecore
• Using things from tier1 is fine
• Using things from tier2 is forbidden

Status	Description	Notes	Contact
TODO	./dialogs/kaboutapplicationdialog.h (probably difficult)	...	<[email protected]>
TODO	./dialogs/kbugreport.h	...	<[email protected]>
TODO	./dialogs/ktip.h	...	<[email protected]>
TODO	./widgets/khelpmenu.h	...	<[email protected]>

ItemViews

Points to verify before moving a class in ItemViews:

• It doesn't use anything aimed at KCompletion (e.g. KLineEdit or KComboBox)
• It doesn't use ki18n
• It doesn't use anything from kdecore
• It doesn't use anything from kwidgets
• Using things from tier1 is fine

Status	Description	Notes	Contact
TODO	./itemviews/kcategorizedview.h	...	<[email protected]>
TODO	./itemviews/klistwidgetsearchline.h (port away from KlineEdit and i18n)	...	<[email protected]>
TODO	./itemviews/ktreewidgetsearchline.h (port away from KlineEdit and i18n)	...	<[email protected]>
TODO	./itemviews/kcategorizedsortfilterproxymodel.h (need porting away from KstringHandler)	...	<[email protected]>
TODO	./itemviews/kwidgetitemdelegate.h	...	<[email protected]>
TODO	./itemviews/kfilterproxysearchline.h (port away from KlineEdit and i18n)	...	<[email protected]>
TODO	./itemviews/kcategorydrawer.h	...	<[email protected]>

KCompletion

Points to verify before moving a class in KCompletion:

• It doesn't use anything from kwidgets
• It doesn't use anything from kdecore
• It doesn't use anything from kdeui
• Using things from tier1 is fine

Status	Description	Notes	Contact
TODO	./widgets/khistorycombobox.h	...	<[email protected]>
TODO	./widgets/kcombobox.h	...	<[email protected]>
TODO	./widgets/klineedit.h	...	<[email protected]>
TODO	./widgets/kcompletionbox.h	...	<[email protected]>
DONE	./util/kcompletion.h move ksortablelist.h with it	...	<[email protected]>

KConfigWidgets

Points to verify before moving a class in KConfigWidgets:

• It uses only classes from kconfigcore, kconfigui or kwidgetsaddons

Status	Description	Notes	Contact
TODO	./dialogs/kconfigdialogmanager.h	...	<[email protected]>
TODO	./dialogs/kconfigdialog.h	...	<[email protected]>
TODO	./widgets/kcmodule.h	...	<[email protected]>
TODO	./itemviews/kviewstatesaver.h	...	<[email protected]>
TODO	./itemviews/kviewstatemaintainer.h	...	<[email protected]>

KCrash

Important: At time of writing the KCrash framework doesn't exist yet in staging, the person picking the first move task here would have to do that.

Points to verify before moving a class in KCrash:

• It uses only classes from kcoreaddons or kwindowsystem

Status	Description	Notes	Contact
TODO	./util/kcrash.h	...	<[email protected]>

KIconThemes

Points to verify before moving a class in KIconThemes:

• It uses only classes from tier1 or tier2
• It uses nothing from kdeui or kdecore

Status	Description	Notes	Contact
TODO	./util/kpixmapsequencewidget.h	...	<[email protected]>
TODO	./util/kpixmapsequenceoverlaypainter.h	...	<[email protected]>
TODO	./util/kpixmapsequence.h	...	<[email protected]>
TODO	./icons/kiconbutton.h	...	<[email protected]>
TODO	./icons/kicondialog.h	...	<[email protected]>

KJobWidgets

Points to verify before moving a class in KJobWidgets:

• It uses only classes from Qt, kcoreaddons or kwidgetsaddons

Status	Description	Notes	Contact
TODO	./jobs/kwidgetjobtracker.h	...	<[email protected]>
TODO	./jobs/kabstractwidgetjobtracker.h	...	<[email protected]>
TODO	./jobs/kdialogjobuidelegate.h	...	<[email protected]>
TODO	./jobs/kstatusbarjobtracker.h	...	<[email protected]>

KNotifications

Points to verify before moving a class in KNotifications:

• It uses only classes from KWindowSystem, QtWidgets, QtDBus

Status	Description	Notes	Contact
TODO	./notifications/kstatusnotifieritem.h	...	<[email protected]>
TODO	./notifications/knotificationrestrictions.h	...	<[email protected]>

KWallet

Important: At time of writing the KWallet framework doesn't exist yet in staging, the person picking the first move task here would have to do that.

Points to verify before moving a class in KWallet:

• It uses only classes from kconfigcore, kconfigui or kwindowsystem

Status	Description	Notes	Contact
TODO	./util/kwallet.h	...	<[email protected]>

XmlGui

Points to verify before moving a class in XmlGui:

• It uses only classes from tier1 or tier2
• It uses nothing from kdeui or kdecore

Status	Description	Notes	Contact
TODO	./dialogs/kshortcutseditor.h	...	<[email protected]>
TODO	./dialogs/kshortcutsdialog.h	...	<[email protected]>
TODO	./dialogs/kedittoolbar.h	...	<[email protected]>
TODO	./widgets/kshortcutwidget.h	...	<[email protected]>
TODO	./widgets/kkeysequencewidget.h	...	<[email protected]>
TODO	./util/kundoactions.h	...	<[email protected]>
TODO	./kdepackages.h (goes with kbugreport)	...	<[email protected]>
TODO	./xmlgui/kxmlguiclient.h	...	<[email protected]>
TODO	./xmlgui/kxmlguiwindow.h	...	<[email protected]>
TODO	./xmlgui/kxmlguifactory.h	...	<[email protected]>
TODO	./xmlgui/kmainwindow.h	...	<[email protected]>
TODO	./xmlgui/kxmlguibuilder.h	...	<[email protected]>
TODO	./xmlgui/ktoolbar.h	...	<[email protected]>
TODO	./shortcuts/kcheckaccelerators.h	...	<[email protected]>
TODO	./actions/kactioncollection.h	...	<[email protected]>
TODO	./actions/ktoggletoolbaraction.h	...	<[email protected]>
TODO	./actions/kactioncategory.h	...	<[email protected]>

KTextWidgets

Important: At time of writing the KTextWidgets framework doesn't exist yet in staging, the person picking the first move task here would have to do that.

Points to verify before moving a class in KTextWidgets:

• It uses only classes from tier1 or tier2
• It uses nothing from kdeui or kdecore

Status	Description	Notes	Contact
TODO	./findreplace/kfinddialog.h	...	<[email protected]>
TODO	./findreplace/kreplacedialog.h	...	<[email protected]>
TODO	./findreplace/kfind.h	...	<[email protected]>
TODO	./findreplace/kreplace.h	...	<[email protected]>
TODO	./widgets/krichtextwidget.h	...	<[email protected]>
TODO	./widgets/nestedlisthelper.h (goes with krichtextedit)	...	<[email protected]>
TODO	./widgets/ktextedit.h	...	<[email protected]>
TODO	./widgets/krichtextedit.h	...	<[email protected]>