syncevolution/src/backends/sqlite/README

29 lines
1.0 KiB
Plaintext
Raw Normal View History

This is a demo backend. It uses a database schema that is similar to
the one used on the iPhone, but it is not as complete.
To compile this backend as part of SyncEvolution, configure with
--enable-sqlite.
To compile it against a binary distribution of SyncEvolution, make
sure that the SyncEvolution, Synthesis and sqlite developer files are
installed and that pkg-config can find syncevolution.pc, synthesis.pc
and sqlite.pc. Set your PKG_CONFIG_PATH if necessary.
Then the source files can be compiled as follows:
g++ -fpic -DPIC -DENABLE_SQLITE -shared -I. \
`pkg-config --cflags --libs syncevolution`
`pkg-config --cflags --libs sqlite`
*.cpp \
-o /tmp/syncsqlite.so
Install /tmp/syncsqlite.so by moving it into the
"lib/syncevolution/backends" directory of the SyncEvolution
installation.
It then should show up as additional choice for the "type" property:
source -> datastore rename, improved terminology The word "source" implies reading, while in fact access is read/write. "datastore" avoids that misconception. Writing it in one word emphasizes that it is single entity. While renaming, also remove references to explicit --*-property parameters. The only necessary use today is "--sync-property ?" and "--datastore-property ?". --datastore-property was used instead of the short --store-property because "store" might be mistaken for the verb. It doesn't matter that it is longer because it doesn't get typed often. --source-property must remain valid for backward compatility. As many user-visible instances of "source" as possible got replaced in text strings by the newer term "datastore". Debug messages were left unchanged unless some regex happened to match it. The source code will continue to use the old variable and class names based on "source". Various documentation enhancements: Better explain what local sync is and how it involves two sync configs. "originating config" gets introduces instead of just "sync config". Better explain the relationship between contexts, sync configs, and source configs ("a sync config can use the datastore configs in the same context"). An entire section on config properties in the terminology section. "item" added (Todd Wilson correctly pointed out that it was missing). Less focus on conflict resolution, as suggested by Graham Cobb. Fix examples that became invalid when fixing the password storage/lookup mechanism for GNOME keyring in 1.4. The "command line conventions", "Synchronization beyond SyncML" and "CalDAV and CardDAV" sections were updated. It's possible that the other sections also contain slightly incorrect usage of the terminology or are simply out-dated.
2014-07-28 15:29:41 +02:00
syncevolution --datastore-property type=?
...
SQLite Address Book = addressbook = contacts = sqlite-contacts
vCard 2.1 (default) = text/x-vcard