Documentation update.

diff --git a/base/i2-base.h b/base/i2-base.h
index dea64ff244516133409fd9ff9f13e52a141d1e67..010c44374cf951679b42cd70d65ba01a3dfbe022 100644 (file)
--- a/base/i2-base.h
+++ b/base/i2-base.h
@@ -21,13 +21,32 @@
 #define I2BASE_H
 
 /**
- * @mainpage Foo
+ * @mainpage Icinga Documentation
+ *
+ * Icinga implements a framework for run-time-loadable components which can
+ * pass messages between them. These components can either be hosted in the
+ * same process or in several host processes (either on the same machine or
+ * on different machines).
+ *
+ * The framework's code critically depends on the following patterns:
+ *
+ * -Smart pointers
+ *
+ * The shared_ptr and weak_ptr template classes are used to simplify memory
+ * management and to avoid accidental memory leaks and use-after-free bugs.
+ *
+ * -Observer pattern
+ *
+ * Framework classes expose events which other objects can subscribe to. This
+ * is used to decouple clients of a class from the class' internal
+ * implementation.
  */
 
 /**
  * @defgroup base Base class library
  *
- * Hello World.
+ * The base class library implements commonly-used functionality like
+ * event handling for sockets and timers.
  */
 
 #ifdef _MSC_VER

diff --git a/icinga/i2-icinga.h b/icinga/i2-icinga.h
index 67a7859536db9b53a887d4671afdae5163b0e45c..cc0f50cea2428d42202a2df70447d3bbe22e82b7 100644 (file)
--- a/icinga/i2-icinga.h
+++ b/icinga/i2-icinga.h
@@ -22,6 +22,9 @@
 
 /**
  * @defgroup icinga Icinga application
+ *
+ * The Icinga application is in charge of boot-strapping the Icinga
+ * environment and loading additional components.
  */
 
 #include <i2-base.h>

diff --git a/jsonrpc/i2-jsonrpc.h b/jsonrpc/i2-jsonrpc.h
index 240247a84b87ce20cfc62e440f38f0f30bab7635..1fdd52d83779fcab0bbfa34f7dcc08fccb66ad24 100644 (file)
--- a/jsonrpc/i2-jsonrpc.h
+++ b/jsonrpc/i2-jsonrpc.h
@@ -22,6 +22,9 @@
 
 /**
  * @defgroup jsonrpc JSON-RPC
+ *
+ * The JSON-RPC library implements server and client classes for the JSON-RPC
+ * protocol.
  */
 
 #include <map>