Frameworks/Epics/Splitting kdelibs: Difference between revisions
more cmake todos, discussed with alex |
add QCoreApplication::translate requirement |
||
Line 24: | Line 24: | ||
* Does not use any Q_WS_* defines (for Qt 5). | * Does not use any Q_WS_* defines (for Qt 5). | ||
* Does not include config.h. | * Does not include config.h. | ||
* Does not use QObject::tr(), but only QCoreApplication::translate() with an empty context, for gettext compatibility (po->ts, no context available). A bit ugly, could be removed later on, with either a PoTranslator (to load .po files directly) or whatever Oswald has in mind for a new Qt translation system. | |||
* See [[Frameworks/Epics/kdelibs_cleanups]] for more details | * See [[Frameworks/Epics/kdelibs_cleanups]] for more details | ||
Revision as of 16:47, 9 August 2012
kdelibs splitting epic
Important Forewords
If you are working on splitting a framework, make sure to consult our list of common issues. It will give you an overview of the solutions you're supposed to use to deal with some of the dependencies.
Also, when splitting out a framework, it is part of being done to comply with the KDE Frameworks Policies, it will also need to follow this Epic Policies. Any framework in the staging area cannot move to its final place without following those policies.
And last but not least, if you create a new framework, please consider being its maintainer as well. We need people to ensure the stewardship of all the frameworks.
Existing frameworks
Definition of done:
- No dependency on kdecore, kdeui, kio, kparts...
- Modularized CMakeLists.txt [using ECM]
- Installs a Config.cmake file for itself [this is done automatically by extra-cmake-modules]
- Does not install any Find*.cmake modules itself
- Calls feature_summary at the end of the toplevel CMakeLists.txt (see kcoreaddons for an example)
- All Find*.cmake modules needed by the framework and used also by other frameworks have been upstreamed to extra-cmake-modules (via the kde-buildsystem mailing list) or directly to cmake (via the cmake list). To make sure of this, do not append to CMAKE_MODULE_PATH, but set it.
- Does not set EXECUTABLE_OUTPUT_PATH anymore.
- Follows the policy on directory organization
- Unit tested
- Maintains source compatibility over kdelibs
- Does not use any Q_WS_* defines (for Qt 5).
- Does not include config.h.
- Does not use QObject::tr(), but only QCoreApplication::translate() with an empty context, for gettext compatibility (po->ts, no context available). A bit ugly, could be removed later on, with either a PoTranslator (to load .po files directly) or whatever Oswald has in mind for a new Qt translation system.
- See Frameworks/Epics/kdelibs_cleanups for more details
February Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
DONE | itemmodels | Tier 1 | Functional | Stephen Kelly | |
DONE | kdbusaddons | Tier 1 | Functional | Kevin Ottens | |
DONE | kplotting | Tier 1 | Functional | Benjamin Port | |
DONE | solid | Tier 1 | Integration | Alex Fiestas | |
DONE | threadweaver | Tier 1 | Functional | Mirko Boehm |
March Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
DONE | kauth | Tier 2 | Integration | Dario Freddi | |
DONE | kcoreaddons | Tier 1 | Functional | Romain Perier/David Faure | |
DONE | kwindowsystem | Tier 1 | Integration | Martin Graesslin |
April Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|
May Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
DONE | karchive | Tier 1 | Functional | Mario Bensi | |
DONE | kconfig | Tier 2 | Functional | ? |
Details on KConfig/DConf, etc. Benjamin completing for the move with Kevin's help
|
DONE | idletime | Tier 1 | Integration | Dario Freddi |
June Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
IN PROGRESS | kbookmarks | Tier ? (2 or 3) | Functional | Julien Desgats | Right now in kio/bookmarks. |
TODO | kservice | Tier 3 | Solution | ?? | Right now in kdecore/services |
DONE | kconfiggui | Tier 2 | Functional | ? |
July Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
TODO | itemviews | Tier 3 | Functional | Stephen Kelly? | |
IN PROGRESS | kguiaddons | Tier 1 | Functional | ?? | Will contain the non-QWidget based classes from kdelibs/kdeui |
IN PROGRESS | color widgets | Tier 2 | Functional | ?? | Right now in kdeui/colors. Being splitted by Giorgos Tsiapaliwkas |
TODO | job widgets | Tier 2 | Functional | Kevin Ottens | Right now in kdeui/jobs |
TODO | dialogs | Tier 3 | Functional | ?? | Right now in kdeui/dialogs |
TODO | widgets | Tier 2 | Functional | ?? | Right now in kdeui/widgets. Decide which widgets are and should be 'KDE focussed', and which have use cases outside of KDE http://thread.gmane.org/gmane.comp.kde.devel.frameworks/473/ |
August Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
TODO | emoticons | Tier 3 | Functional | ?? | Right now in kutils/kemoticons |
TODO | XMLGUI | Tier 3 | Functional | ?? | Right now in kdeui/actions and kdeui/xmlgui |
IN PROGRESS | sonnet | Tier 2 | Functional | ??? |
|
September Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
TODO | kcmutils | Tier 4 | N/A | ?? | Right now in kutils/kcmutils |
TODO | kparts | Tier 4 | N/A | ?? | Right now in kparts |
TODO | kde "consistency" | Tier 4 | N/A | ?? |
October Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
TODO | kio-core | Tier ? | Solution | David Faure | |
TODO | kio-widgets | Tier ? | Solution | David Faure |
November Iteration
Status | Framework | Tier | Type | Maintainer | Comment |
---|---|---|---|---|---|
IN PROGRESS | KDE Notifications Frameworks | probably tier2+3+5 | Functional or integration | Sune |
|
IN PROGRESS | libplasma2 | Tier 3 | Solution | Aaron Seigo, Marco Martin |
|
IN PROGRESS | kde4support | Tier 4 | N/A | David Faure |
Backlog
For reference, find the class by class analysis produced during Platform11 on the kdelibs dependencies page
This list is non-final, hence why it is not integrated in the table above, when the scope of a lib gets defined and worked on, it is removed from this list and go in the table above.
Yet to be produced frameworks (foreseen tier and type, not set in stone):
- Tier 3
- libkdebug (Tier 3 / Functional) / Depends on the results coming from qDebug() in Qt5
And probably more...
Finalization tasks
To be executed to complete the epic when all the frameworks are "done":
- Remove libinqt5
- Port to qt master (likely upcoming 5.1)
- Split into its own git module; pre-existing history will remain in the kdelibs repository and be accessible with git graft
Policies
Strive for Source Compatibility
Avoid removing API from the frameworks branch, even if it is replaced or deprecated. Prefer to implement the old API in terms of the new API.
In some cases this is very easy. For example, many APIs in KGlobal will be replaced as part of the frameworks effort.
- KGlobal::charsets() -> KCharsets::charsets()
- KGlobal::dirs() -> KStandardDirs::global() (or something?)
- KGlobal::ref() -> qApp->ref()
- KGlobal::deref() -> qApp->deref()
etc.
Removing this API from KGlobal is not necessary in most cases, and it introduces a porting burden which is best avoided.
There is unlikely to be a 1:1 mapping of old API to new API in every case, so how to implement the old API may not always be obvious. However, attempting to ensure that the older API remains useful should be at the front of our efforts and standards in the frameworks branch.
Binary compatibility policy relaxed
During the execution of this epic, the binary compatibility contraints from the global policy list is lifted.