summaryrefslogtreecommitdiffstats
path: root/kpilot/Mainpage.dox
diff options
context:
space:
mode:
Diffstat (limited to 'kpilot/Mainpage.dox')
-rw-r--r--kpilot/Mainpage.dox31
1 files changed, 31 insertions, 0 deletions
diff --git a/kpilot/Mainpage.dox b/kpilot/Mainpage.dox
new file mode 100644
index 000000000..7e0b086c3
--- /dev/null
+++ b/kpilot/Mainpage.dox
@@ -0,0 +1,31 @@
+/** \mainpage %KPilot API Overview
+
+\section Architecture
+
+%KPilot consists of a core library of utility and communications
+classes which are used by two applications: KPilot itself
+(which is little more than a clumsy data viewer and
+configuration shell) and the KPilot daemon which does
+the actual communications with the hadheld.
+The daemon loads plugins (called conduits) on demand
+which are used for syncing specific data on the PC
+with the handheld.
+
+The lib/ directory holds the base library for KPilot.
+This boils down to a bunch of wrappers for pilot-link
+classes (not using p-l's C++ code because that isn't
+Qt-ish) and a few classes that do interesting things:
+KPilotDeviceLink for managing the device connection,
+and SyncAction for doing stuff during a sync.
+
+The kpilot/ directory houses several applications:
+kpilot and kpilotDaemon are installed, and kpilotTest
+which is not installed but which can function as a demon
+under closely-controlled circumstances from the command-line.
+
+Under conduits/ a bunch of directories hold the individual
+conduits; the "four button" apps are in vcalconduit/ (ToDo and
+Datebook), abbrowserconduit/ (Addresses, not the newer Contacts)
+and knotes/ or memofileconduit/ (Memos).
+
+*/