diff options
Diffstat (limited to 'doc/devel')
-rw-r--r-- | doc/devel/calendar/architecture.sgml | 39 | ||||
-rw-r--r-- | doc/devel/evolution-devel-guide.sgml | 1 |
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> |