aboutsummaryrefslogtreecommitdiffstats
path: root/doc/devel
diff options
context:
space:
mode:
Diffstat (limited to 'doc/devel')
-rw-r--r--doc/devel/calendar/architecture.sgml39
-rw-r--r--doc/devel/evolution-devel-guide.sgml1
2 files changed, 36 insertions, 4 deletions
diff --git a/doc/devel/calendar/architecture.sgml b/doc/devel/calendar/architecture.sgml
index b174965fc3..d4524fa857 100644
--- a/doc/devel/calendar/architecture.sgml
+++ b/doc/devel/calendar/architecture.sgml
@@ -1,12 +1,43 @@
- <chapter>
- <title>Overview of the Calendar</title>
+ <chapter id="calendar-architecture">
+ <title>Architecture of the Calendar</title>
<para>
This chapter gives an overview of the Evolution Calendar
architecture. It describes the model/view split of the calendar
- into a personal calendar server (PCS) and the GUI clients that
- appear inside the Evolution shell.
+ into a personal calendar server, or PCS, and the GUI clients
+ that appear inside the Evolution shell.
</para>
+
+ <sect1 id="calendar-model-view">
+ <title>Model/view separation</title>
+
+ <para>
+ Like other base components in Evolution, the calendar
+ separates the data model from the views or clients. This is
+ done so that multiple clients can access the same calendar
+ data in an orderly fashion and without clashes. For example,
+ the user may be running a graphical calendar client. If he
+ then wants to synchronize his calendar with a handheld device,
+ then the corresponding synchronization program (e.g. a conduit
+ for the <application>gnome-pilot</application> package) will
+ also need to access the calendar storage. It is important
+ that both the GUI client and the synchronization program keep
+ a consistent view of the calendar at all times, otherwise one
+ of them will be left in an inconsistent state if the
+ calendar's data changes unexpectedly.
+ </para>
+
+ <para>
+ Evolution puts the calendar storage in a daemon called the
+ Wombat and completely separates it from clients who wants to
+ access calendar data. This part of the Wombat is called the
+ personal calendar server, or &PCS;. Clients must contact the
+ &PCS; and ask it to open an existing calendar or create a new
+ one. When a calendar component object (e.g. an appointment or
+ to-do item) changes in the &PCS; it will notify all the
+ clients that are using the component's parent calendar.
+ </para>
+ </sect1>
</chapter>
<!--
diff --git a/doc/devel/evolution-devel-guide.sgml b/doc/devel/evolution-devel-guide.sgml
index e1637cde3c..f6b942b3d8 100644
--- a/doc/devel/evolution-devel-guide.sgml
+++ b/doc/devel/evolution-devel-guide.sgml
@@ -3,6 +3,7 @@
<!entity calendar-architecture SYSTEM "calendar/architecture.sgml">
<!entity calendar-reference SYSTEM "calendar/reference.sgml">
<!entity CalClient SYSTEM "calendar/cal-client/sgml/cal-client.sgml">
+<!entity PCS "<acronym>PCS</acronym>">
]>
<book>