~ubuntu-branches/ubuntu/utopic/kopete/utopic

1 by Jonathan Riddell
Import upstream version 4.10.80
1
Last update: 27 december 2006.
2
3
This is a non-exhaustive guide to porting code from Kopete >= 0.11 (based on KDE3.x) to Kopete4 (based on KDE 4.x).
4
5
Libkopete changes
6
-----------------
7
*) Kopete::Account
8
   - contacts() now return a const QHash<QString,Contact*>&
9
   - setOnlineStatus() reason optional parameter use Kopete::StatusMessage.
10
   - NEW: setStatusMessage() which take a Kopete::StatusMessage.
11
12
*) Kopete::AccountManager
13
   - accounts() now return a QList<Account*>.
14
15
*) KopeteAwayDialog
16
   - removed. KopeteAwayAction should be used instead
17
18
*) Kopete::ChatSessionManager
19
   - sessions() now return a QList<ChatSession*>
20
21
*) kopetecommandlist.h
22
   - CommandList is now a QMultiHash<QString, Command*>
23
24
*) Kopete::Contact
25
   - NEW: setStatusMessage() and statusMessage().
26
27
*) kopetecontactproperty.h
28
   - Removed bool flags from constructor. Use ContactPropertyOption enum instead.
29
     First bool parameter -> Kopete::ContactPropertyTmpl::PersistentProperty
30
     Second bool parameter -> Kopete::ContactPropertyTmpl::RichTextProperty
31
     Third bool parameter -> Kopete::ContactProperyTmpl::PrivateProperty
32
33
*) kopeteglobal.h
34
   - Renamed Kopete::Global::Properties::awayMessage() to statusMessage()
35
36
*) Kopete::MetaContact
37
   - photo() is now deprecated. Use picture().image() instead.
38
39
*) Kopete::Message
40
   - asXML() no longer exist (removed in 0.12)
41
42
*) Kopete::OnlineStatusManager
43
   - HasAwayMessage enum value was renamed to HasStatusMessage.
44
45
*) NEW: Kopete::StatusMessage
46
   Class that encapsulate normal status message and status metadata(like Now Listening metadata)
47
48
*) kopeteproperties.h
49
   - Replaced PortingDict, now a QMultiHash<QByteArray, PropertyData
50
   - Replaced all const char * parameters with const QByteArray &
51
52
*) KopetePrefs
53
   - Removed. Use the new settings classes (see entry below).
54
55
*) kopetexsl.h
56
   - Was removed in 0.12 version.
57
58
59
-kopetemessagemanager.h and kopetemessagemanagerfactory.h has been removed. Use kopetechatsession.h and kopetechatsessionmanager.h
60
61
*) Configuration/Settings classes changes. 
62
63
KopetePrefs is deprecated and will be removed soon. Please use the new settings classes generated by KConfigXT.
64
-Kopete::AppearanceSettings is for settings related to appearance like fonts, colors and enabled visual items
65
-Kopete::BehaviorSetting is for settings related to Kopete's behavior.
66
-Kopete::Config was renamed to Kopete::GeneralSettings.
67
68
See related .kcfg files for possible entries.
69
70
Other changes
71
-------------
72
If you get problems with UI files that fuck because of some KDE widgets,
73
add those lines to the .ui file (open it as text). Note that it's just a exemple.
74
75
<customwidgets>
76
    <customwidget>
77
       <class>KHistoryCombo</class>
78
       <header>kcombobox.h</header>
79
    </customwidget>
80
    <customwidget>
81
       <class>KPasswordEdit</class>
82
       <header>kpassdlg.h</header>
83
    </customwidget>
84
</customwidgets>