summaryrefslogtreecommitdiffstats
path: root/contrib/caldav/README
diff options
context:
space:
mode:
authorRandy Ramos <rramos1295@gmail.com>2017-09-04 19:29:42 -0400
committerLukas Fleischer <lfleischer@calcurse.org>2017-09-08 22:35:36 +0200
commit0aa717c83d03c249e56d8f216895424d9550d68f (patch)
tree9786f4d2c8537315c0a410046fe0fa17a30a1d08 /contrib/caldav/README
parent479e39fbb7393dcca7d3a475a09128b8c7ea7a43 (diff)
downloadcalcurse-0aa717c83d03c249e56d8f216895424d9550d68f.tar.gz
calcurse-0aa717c83d03c249e56d8f216895424d9550d68f.zip
Rename README to README.md
This ensures that the Markdown syntax is properly displayed by Github and other Markdown readers. Also added quotes to a couple of paths and a flag. Signed-off-by: Randy Ramos <rramos1295@gmail.com> Signed-off-by: Lukas Fleischer <lfleischer@calcurse.org>
Diffstat (limited to 'contrib/caldav/README')
-rw-r--r--contrib/caldav/README67
1 files changed, 0 insertions, 67 deletions
diff --git a/contrib/caldav/README b/contrib/caldav/README
deleted file mode 100644
index 93baf37..0000000
--- a/contrib/caldav/README
+++ /dev/null
@@ -1,67 +0,0 @@
-calcurse-caldav
-===============
-
-calcurse-caldav is a simple Python script that can be used to synchronize
-calcurse with a CalDAV server. Please note that the script is alpha software!
-This means that:
-
-* We are eagerly looking for testers to run the script and give feedback! If
- you find any bugs, please report them to the calcurse mailing lists or to the
- GitHub bug tracker. If the script works fine for you, please report back as
- well!
-
-* The script might still have bugs. MAKE BACKUPS, especially before running
- calcurse-caldav for the first time!
-
-Usage
------
-
-calcurse-caldav requires an up-to-date version of calcurse and a configuration
-file located at ~/.calcurse/caldav/config. An example configuration file can be
-found under contrib/caldav/config.sample in the calcurse source tree. You will
-also need to install *httplib2* for Python 3 using *pip* (e.g. `pip3 install
---user httplib2`) or your distribution's package manager.
-
-If you run calcurse-caldav for the first time, you need to provide the --init
-argument. You can choose between the following initialization modes:
-
- --init=keep-remote Remove all local calcurse items and import remote objects
- --init=keep-local Remove all remote objects and push local calcurse items
- --init=two-way Copy local objects to the CalDAV server and vice versa
-
-For subsequent calcurse-caldav invocations, you don't need to specify any
-additional parameters.
-
-Hooks
------
-
-You can place scripts in `$HOME/.calcurse/caldav/hooks/` to trigger actions at
-certain events. To enable a hook, add a script with one of the following names
-to this directory. Also make sure the scripts are executable.
-
-*pre-sync*::
- Executed before the data files are synchronized.
-*post-sync*::
- Executed after the data files are synchronized.
-
-Some examples can be found in the `contrib/caldav/hooks/` directory of the
-calcurse source tree.
-
-How It Works
-------------
-
-calcurse-caldav creates a so-called synchronization database at
-~/.calcurse/caldav/sync.db that always keeps a snapshot of the last time the
-script was executed. When running the script, it compares the objects on the
-server and the local objects with that snapshot to identify items that were
-added or deleted. It then
-
-* downloads new objects from the server and imports them into calcurse,
-* deletes local objects that no longer exist on the server,
-* uploads objects to the server that were added locally,
-* deleted objects from the server that were deleted locally,
-* updates the synchronization database with a new snapshot.
-
-Note: Since calcurse does not use unique identifiers for items, it cannot keep
-track of moved/edited items. Thus, modifying an item is equivalent to deleting
-the old item and creating a new one.