From 0a8187da947344344d8c841e8c3f05b75c6f6cda Mon Sep 17 00:00:00 2001
From: infirit <infirit@gmail.com>
Date: Sat, 20 Dec 2014 18:26:58 +0100
Subject: gtk doc: Move documentation to inline comments

---
 configure.ac                          | 2 +-
 libmateweather/location-entry.c       | 5 +++--
 libmateweather/mateweather-location.c | 5 +++--
 libmateweather/mateweather-prefs.c    | 5 +++++
 libmateweather/mateweather-timezone.c | 5 +++--
 libmateweather/mateweather-xml.c      | 5 +++++
 libmateweather/timezone-menu.c        | 5 +++--
 libmateweather/weather.c              | 5 +++++
 8 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/configure.ac b/configure.ac
index 5876aa0..0da25f5 100644
--- a/configure.ac
+++ b/configure.ac
@@ -220,7 +220,7 @@ AC_SUBST(GLADEDIR)
 ##################################################
 # Checks for gtk-doc and docbook-tools
 ##################################################
-GTK_DOC_CHECK([1.9])
+GTK_DOC_CHECK([1.11], [--flavour no-tmpl])
 
 dnl ***************************************************************************
 dnl *** Output Makefiles et al                                              ***
diff --git a/libmateweather/location-entry.c b/libmateweather/location-entry.c
index 5da2fcd..7b922b0 100644
--- a/libmateweather/location-entry.c
+++ b/libmateweather/location-entry.c
@@ -28,11 +28,12 @@
 #include <string.h>
 
 /**
- * MateWeatherLocationEntry:
+ * SECTION:location-entry
+ * @Title: MateWeatherLocationEntry
  *
  * A subclass of #GtkEntry that provides autocompletion on
  * #MateWeatherLocation<!-- -->s
- **/
+ */
 
 G_DEFINE_TYPE (MateWeatherLocationEntry, mateweather_location_entry, GTK_TYPE_ENTRY)
 
diff --git a/libmateweather/mateweather-location.c b/libmateweather/mateweather-location.c
index df205d4..88aa647 100644
--- a/libmateweather/mateweather-location.c
+++ b/libmateweather/mateweather-location.c
@@ -35,13 +35,14 @@
 #include "weather-priv.h"
 
 /**
- * MateWeatherLocation:
+ * SECTION:mateweather-location
+ * @Title: MateWeatherLocation
  *
  * A #MateWeatherLocation represents a "location" of some type known to
  * libmateweather; anything from a single weather station to the entire
  * world. See #MateWeatherLocationLevel for information about how the
  * hierarchy of locations works. 
- **/
+ */
 
 struct _MateWeatherLocation {
     char *name, *sort_name;
diff --git a/libmateweather/mateweather-prefs.c b/libmateweather/mateweather-prefs.c
index 384a761..faae7e8 100644
--- a/libmateweather/mateweather-prefs.c
+++ b/libmateweather/mateweather-prefs.c
@@ -28,6 +28,11 @@
 #include "mateweather-prefs.h"
 #include "weather-priv.h"
 
+/**
+ * SECTION:mateweather-prefs
+ * @Title: mateweather-prefs
+ */
+
 void
 mateweather_prefs_load (MateWeatherPrefs *prefs, GSettings *settings)
 {
diff --git a/libmateweather/mateweather-timezone.c b/libmateweather/mateweather-timezone.c
index 8c75d70..a87c011 100644
--- a/libmateweather/mateweather-timezone.c
+++ b/libmateweather/mateweather-timezone.c
@@ -30,7 +30,8 @@
 #include "weather-priv.h"
 
 /**
- * MateWeatherTimezone:
+ * SECTION:mateweather-timezone
+ * @Title: MateWeatherTimezone
  *
  * A timezone.
  *
@@ -38,7 +39,7 @@
  * be created by calling mateweather_location_new_world() to parse
  * Locations.xml, and then calling various #MateWeatherLocation methods
  * to extract relevant timezones from the location hierarchy.
- **/
+ */
 struct _MateWeatherTimezone {
     char *id, *name;
     int offset, dst_offset;
diff --git a/libmateweather/mateweather-xml.c b/libmateweather/mateweather-xml.c
index 5fee6fe..c736370 100644
--- a/libmateweather/mateweather-xml.c
+++ b/libmateweather/mateweather-xml.c
@@ -32,6 +32,11 @@
 #include "mateweather-xml.h"
 #include "weather-priv.h"
 
+/**
+ * SECTION:mateweather-xml
+ * @Title: mateweather-xml
+ */
+
 static gboolean
 mateweather_xml_parse_node (MateWeatherLocation *gloc,
 			 GtkTreeStore *store, GtkTreeIter *parent)
diff --git a/libmateweather/timezone-menu.c b/libmateweather/timezone-menu.c
index eb34931..974afb2 100644
--- a/libmateweather/timezone-menu.c
+++ b/libmateweather/timezone-menu.c
@@ -29,10 +29,11 @@
 #include <string.h>
 
 /**
- * MateWeatherTimezoneMenu:
+ * SECTION:timezone-menu
+ * @Title: MateWeatherTimezoneMenu
  *
  * A #GtkComboBox subclass for choosing a #MateWeatherTimezone
- **/
+ */
 
 G_DEFINE_TYPE (MateWeatherTimezoneMenu, mateweather_timezone_menu, GTK_TYPE_COMBO_BOX)
 
diff --git a/libmateweather/weather.c b/libmateweather/weather.c
index 7e61b42..38e650b 100644
--- a/libmateweather/weather.c
+++ b/libmateweather/weather.c
@@ -48,6 +48,11 @@
 #define g_memmove memmove
 #endif
 
+/**
+ * SECTION:weather
+ * @Title: weather
+ */
+
 static void _weather_internal_check (void);
 
 
-- 
cgit v1.2.1