Docs: Fix short descriptions

10 files changed, 29 insertions, 7 deletions

diff --git a/libzeitgeist/data-source-registry.vala b/libzeitgeist/data-source-registry.vala
index 607c5441..dbebcc3a 100644
--- a/libzeitgeist/data-source-registry.vala
+++ b/libzeitgeist/data-source-registry.vala
@@ -18,6 +18,10 @@
  *
  */
 
+/**
+ * Query the Zeitgeist Data-Source Registry extension
+ */
+
 namespace Zeitgeist
 {
 
diff --git a/libzeitgeist/data-source.vala b/libzeitgeist/data-source.vala
index 32a4901b..d398e2ca 100644
--- a/libzeitgeist/data-source.vala
+++ b/libzeitgeist/data-source.vala
@@ -1,7 +1,7 @@
 /* data-source.vala
  *
  * Copyright © 2011 Michal Hruby <michal.mhr@gmail.com>
- * Copyright © 2011, 2012 Collabora Ltd.
+ * Copyright © 2011-2012 Collabora Ltd.
  *             By Siegfried-Angel Gevatter Pujals <siegfried@gevatter.com>
  *
  * This program is free software: you can redistribute it and/or modify
@@ -19,6 +19,10 @@
  *
  */
 
+/**
+ * Abstracts data sources used by the Data-Source Registry extension
+ */
+
 namespace Zeitgeist
 {
     public class DataSource: Object
diff --git a/libzeitgeist/datamodel.vala b/libzeitgeist/datamodel.vala
index 4468e87a..a6f64cee 100644
--- a/libzeitgeist/datamodel.vala
+++ b/libzeitgeist/datamodel.vala
@@ -24,6 +24,10 @@
 
 using Zeitgeist;
 
+/**
+ * Data model for Zeitgeist (Event, Subject, TimeRange, ResultType, etc.)
+ */
+
 namespace Zeitgeist
 {
     [DBus (name = "org.gnome.zeitgeist.DataModelError")]
diff --git a/libzeitgeist/log.vala b/libzeitgeist/log.vala
index 4bdcf0d7..8d50e002 100644
--- a/libzeitgeist/log.vala
+++ b/libzeitgeist/log.vala
@@ -25,8 +25,6 @@ namespace Zeitgeist
 {
 
 /**
- * SECTION:zeitgeist-log
- *
  * Primary access point for talking to the Zeitgeist daemon
  *
  * include: zeitgeist.h
diff --git a/libzeitgeist/mimetype.vala b/libzeitgeist/mimetype.vala
index 61bd51b3..c7922384 100644
--- a/libzeitgeist/mimetype.vala
+++ b/libzeitgeist/mimetype.vala
@@ -22,6 +22,10 @@
 
 using Zeitgeist;
 
+/**
+ * Mime-Type mapping and URI comprehension
+ */
+
 namespace Zeitgeist
 {
 
diff --git a/libzeitgeist/monitor.vala b/libzeitgeist/monitor.vala
index ee1bf209..f6b783f7 100644
--- a/libzeitgeist/monitor.vala
+++ b/libzeitgeist/monitor.vala
@@ -21,8 +21,6 @@
  */
 
 /**
- * SECTION:zeitgeist-monitor
- *
  * Listens for updates to the Zeitgeist event log
  *
  * include: zeitgeist.h
diff --git a/libzeitgeist/ontology.vala.in b/libzeitgeist/ontology.vala.in
index 7f5cbedf..63171701 100644
--- a/libzeitgeist/ontology.vala.in
+++ b/libzeitgeist/ontology.vala.in
@@ -20,6 +20,10 @@
  *
  */
 
+/**
+ * Get information about interpretation/manifestation symbols
+ */
+
 namespace Zeitgeist
 {
 
diff --git a/libzeitgeist/queued-proxy-wrapper.vala b/libzeitgeist/queued-proxy-wrapper.vala
index 5bdc596c..7bebe52a 100644
--- a/libzeitgeist/queued-proxy-wrapper.vala
+++ b/libzeitgeist/queued-proxy-wrapper.vala
@@ -21,6 +21,10 @@
  *
  */
 
+/**
+ * FOR INTERNAL USE ONLY.
+ */
+
 namespace Zeitgeist
 {
 
diff --git a/libzeitgeist/timestamp.vala b/libzeitgeist/timestamp.vala
index 570c3156..462332a7 100644
--- a/libzeitgeist/timestamp.vala
+++ b/libzeitgeist/timestamp.vala
@@ -23,8 +23,6 @@
 using Zeitgeist;
 
 /**
- * SECTION:zeitgeist-timestamp
- *
  * Convenience functions for dealing with timestamps and dates
  *
  * include: zeitgeist.h
diff --git a/libzeitgeist/utils.vala b/libzeitgeist/utils.vala
index c4b7a5cf..c9032f3b 100644
--- a/libzeitgeist/utils.vala
+++ b/libzeitgeist/utils.vala
@@ -21,6 +21,10 @@
  *
  */
 
+/**
+ * Utility functions. FOR INTERNAL USE ONLY
+ */
+
 namespace Zeitgeist
 {
     namespace Utils