* fix the url handling of '&'; it's a bit hairy because of the
[modest] / libmodest-dbus-client / moving-to-libmodest-dbus-client.txt
1 Moving to libmodest-dbus-client
2 Time-stamp: <2007-10-11 18:16:37 (djcb)>
3 ========================================
4
5 Some notes on how to migrate from osso-email-interface to the 
6 new libmodest-dbus-client.
7
8 1. debian/control
9 =================
10 In your debian/control-file, add "libmodest-dbus-client-dev" to your
11 Build-Depends, and remove any reference to osso-email-interface.
12
13
14 2. configure.(ac|in)
15 ====================
16 Add libmodest-dbus-client-1.0 to your modules, e.g.
17 PKG_CHECK_MODULES(LIBMODEST_DBUS_CLIENT,[libmodest-dbus-client-1.0])
18 and, again, remove all reference to osso-email-interface,
19 libossoemailinterface and friends.
20
21 3. #include
22 ===========
23 In your implementation files, remove (again) al references to
24 osso-email-interface, and add:
25 #include <libmodest-dbus-client/libmodest-dbus-client.h>  
26  
27
28 4. replacing calls to osso-email-interface
29 ==========================================
30 After all this has been done, all that is left is replacing the
31 library calls.
32
33 We give the osso-email-interface calls, and the corresponding
34 libmodest-dbus-client call:
35
36
37 1. osso_email_files_email (osso_ctx, my_file_list);
38 becomes:
39      libmodest_dbus_client_compose_mail (osso_ctx, NULL, NULL, NULL, NULL, NULL, my_file_list);
40
41
42
43
44 2. osso_email_url_email (osso_ctx, url);
45 becomes:
46      libmodest_dbus_client_compose_mail (osso_ctx, NULL, NULL, NULL, NULL, url, NULL);                
47
48
49
50
51 3. osso_email_emailto_email (osso_ctx, to_list);
52 becomes:
53      libmodest_dbus_client_mail_to (osso_ctx, to_list as_string);
54
55 NOTE: libmodest_dbus_client expects to_list_as string, ie. a comma-separated
56 list of email addresses.
57
58
59
60 Compile & run. That should do it! If you have any questions, pls. send them to
61 dirk-jan.binnema@nokia.com
62
63
64