PIM Apis

Jump to: navigation, search

Note: this is all just my (markg85) idea. Anything below can change and as of this moment (may 21) there is no change in the api's as they are on api.kde.org. Below is just what i would like to change.


Contents

akonadi

contact

kmime

Both don't have any documentation. What are those doing?


kabc

Warning.png Deprecation Notice Warning.png

Deprecation reason: This API is not the suggested way anymore. The suggested way is to use Akonadi directly. Add the following to KABC documentation: "KABC should be avoided. Use Akonadi directly."

Depreated in KDE version: 4.9
Deleted in KDE version: 5.0



kalarmcal

Seems to be used by KAlarm application. My recommendation would be to deprecate this in 4.9 or 4.10 and remove it in 5.0, but i know others like this class. Keep it as it is?

  • Its purpose is to enable applications other than KAlarm to use KAlarm calendar data. It was moved into kdepimlibs in KDE 4.8 to enable this. Not surprisingly, few if any other applications use it yet, but it's likely that at least Plasma widgets will start using it.

kblog

What's the status on this? Keep it as it is?


kcal

Warning.png Deprecation Notice Warning.png

Deprecation reason: Replaced by KCalCore.

Depreated in KDE version: 4.9
Deleted in KDE version: 5.0



kcalcore

Keep it as it is.


kcalutils

Do we need this as a separate API? KCalCore is implementing iCal and vCal as well so why not add this to KCalCore? Recommendation: Move functionality to KCalCore Deprecate in 4.9 (or 4.10) Delete in 5.0


kholidays

What's the status on this? Keep it as it is?


kimap

There is this one and the one below here as a kioslave.. The names seem - at the very least - confusion since both are "imap" stuff. Some more detailed description as to which one is doing what would be welcome. My guess (don't know for sure) is that this one is for making a mail client and the kioslave one is for making shared internet folders..?? More documentation needed.


kioslave

imap4

More documentation needed. (see comment above from KImap)


mbox

What is this? It misses any documentation.


nntp

What is this? It misses any documentation.


kldap

What is this? It misses any documentation.


kmbox

Same story as the mbox in kioslave. And it misses documentation.


kmime

Same story as the mime in akonadi. It has very detailed documentation. Which one should be used? This one or the one in akonadi?


kontactinterface

It could use some more documentation.


kpimidentities

What is this? It misses any documentation.


kpimtextedit

Keep it as it is.


richtextbuilders

What is this? It misses any documentation.


kpimutils

From the limited documentation this seems to belong in one of the mime classes. I'm not sure but how about merging those with one of the mime classes and deprecating this one followed by a remove in kde 5?


kresources

Don't know.. From the documentation (which it has quite extensively) it seems to be usable for KABC and perhaps KCal - both are not even recommended to use anymore - and i can't seem to find any trace of this in KCalCore (from a quick glance) so this class "seems" to be unused. Difficult to check since lxr.kde.org seems to be dead a.t.m.

I'm not sure, but leaning towards deprecation in KDE 4.9/4.10 and removal in KDE 5. Some more info on this class would be welcome.

ktnef

Keep it as it is.


kxmlrpcclient

Keep it as it is.


mailtransport

Keep it as it is.


microblog

kblog and kmicroblog. I'm guessing those should be merged with kblog. Recommendation: Merge with kblog. Deprecate in KDE 4.9/4.10 Remove in KDE 5


qgpgme

No documentation, no class list at all. Only a file list. Either fix or remove this one.


syndication

Keep it as it is.


atom

No documentation.


rdf

No documentation.

rss2

No documentation.


This page was last modified on 23 May 2012, at 09:18. This page has been accessed 579 times. Content is available under Creative Commons License SA 3.0 as well as the GNU Free Documentation License 1.2.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal