syncevolution/README.packagers

Some of the advanced features of SyncEvolution depend on optional
packages.  In addition to the more obvious dependencies of the
backends there are more subtle dependencies:

- for good time zone support, libsynthesis must have access to
  either libical or libecal
- direct sync with phones depends on bluez and openobex
- GNOME Bluetooth Panel needs libgnome-bluetooth-dev *AND*
  --enable-gnome-bluetooth-panel
- either glib or libnss should be available, so that
  SyncEvolution can use SHA-256 hashes instead of a
  weaker built-in algorithm for hashes in the database dump
  .ini files
- libnotify is needed by the syncevo-dbus-server, although
  --disable-notify can be used to avoid that.
- Localization data is shared between sync-ui and syncevo-dbus-server
  and thus needs to be packaged with the core SyncEvolution.
README.packagers: document pitfalls for packagers Mention libical/ecal dependency of libsynthesis and openobex/bluez. 2010-01-26 16:31:10 +01:00			`Some of the advanced features of SyncEvolution depend on optional`
			`packages. In addition to the more obvious dependencies of the`
			`backends there are more subtle dependencies:`

			`- for good time zone support, libsynthesis must have access to`
			`either libical or libecal`
			`- direct sync with phones depends on bluez and openobex`
autotools: build GNOME Bluetooth panel plugin (MB #7089) The GNOME Bluetooth panel plugin needs to be installed into the location used by the system. We guess what that location might be by installing into `pkg-config --variable=libdir gnome-bluetooth-1.0`/plugins. Because this location might not be writable, compiling the plugin is off by default. It can be enabled with --enable-gnome-bluetooth-panel-plugin which depends on the libgnome-bluetooth-dev files. Shared libraries must be enabled when enabling the plugin. Not currently checked by configure. 2010-02-04 14:32:33 +01:00			`- GNOME Bluetooth Panel needs libgnome-bluetooth-dev AND`
			`--enable-gnome-bluetooth-panel`
SHA-256: use glib or Mozilla NSS Stronger hash algorithms are necessary for the identification of file content via a hash value (same approach as in git). SHA-256 is taken from glib if glib is already a SyncEvolution dependency for other reasons, otherwise the configure script looks for Mozilla NSS. Another candidate is libgcrypt, but there's no code for that yet. All of these libraries are LGPL or more liberal, so they don't impose any additional requirements on users of SyncEvolution, in contrast to OpenSSL (advertisement clause!). 2010-02-08 19:42:25 +01:00			`- either glib or libnss should be available, so that`
			`SyncEvolution can use SHA-256 hashes instead of a`
			`weaker built-in algorithm for hashes in the database dump`
			`.ini files`
packaging: fail harder if libnotify is missing (MB #1000). When libnotify was not found, syncevo-dbus-server was silently compiled without notifications, which happened in the MeeGo snapshot .rpms due to missing build dependencies. This patch introduces a --enable/disable-notify switch and aborts if the feature is on (by default or explicitly requested) and the development files are missing. Also document this in README.packagers. 2010-03-31 14:11:40 +02:00			`- libnotify is needed by the syncevo-dbus-server, although`
			`--disable-notify can be used to avoid that.`
			`- Localization data is shared between sync-ui and syncevo-dbus-server`
			`and thus needs to be packaged with the core SyncEvolution.`