git.maemo.org Git - modest/blob - 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