summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Mollekopf <chrigi_1@fastmail.fm>2013-10-05 14:39:39 (GMT)
committerChristian Mollekopf <chrigi_1@fastmail.fm>2013-10-05 14:39:39 (GMT)
commit7b05a4e74ce6291ac933d15125f138f18beb00a3 (patch)
tree15398e7fbe0bd09541be052eeb849aa43a5f2d6a
parent5687ac32902f748d2f46912ec721deba2fde32eb (diff)
downloadlibcalendaring-7b05a4e74ce6291ac933d15125f138f18beb00a3.tar.gz
A Readme
-rw-r--r--README34
1 files changed, 34 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..7f45904
--- /dev/null
+++ b/README
@@ -0,0 +1,34 @@
+== About ==
+Libcalendaring provides a way to distribute required parts of kdelibs and kdepimlibs to distributions that are too old for a recent enough installation of the kde libraries.
+
+It also contains some tweaks to cut some runtime dependencies that are not desirable on the server (ktimezoned, dbus, ...).
+
+So, THIS IS NOT A FORK, it's a temporary workaround until KDE Frameworks is ready (hopefully resulting in a reasonable dependency chain), and all required fixes have been upstreamed.
+Once that has happended libcalendaring will silently become pointless and can be replaced by normal kde packages.
+
+Until then we try hard to diverge as little as possible, and make sure all fixes go to the upstream libraries first, before landing here.
+
+== Submodules ==
+Libcalendaring uses git submodules to track kdepimlibs (and in the future hopefully kdelibs).
+The kolab/libcalendaring/$VERSION branch is used (based on top of kolab/stable/$VERSION), to make it as easy as possible to get relevant patches to libcalendaring and to make sure the normal kdepimlibs distribution stays in sync with libcalendaring.
+
+=== Updating the submodule ===
+To update the submodule to the latest version of the branch recorded in .gitmodules, use:
+ git submodule update --remote
+
+And commit the result in the libcalendaring git repository.
+
+Note that this requires git 1.8.2, otherwise just update the submodule repo manually (cd into it and use the usual git pull), and commit the result in the libcalendaring repo.
+
+
+== Build ==
+
+Because submodules are used, the process requires two commands more than usual:
+
+git clone git://git.kolab.org/git/libcalendaring
+git submodule init
+git submodule update
+mkdir build
+cd build
+cmake ..
+make install