summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorinfirit <[email protected]>2014-12-20 18:26:58 +0100
committerinfirit <[email protected]>2015-08-25 10:48:31 +0200
commit0a8187da947344344d8c841e8c3f05b75c6f6cda (patch)
treef30e83839a5cbce75e8fa513d62d43f8e70e078a
parent0514bcef4eb5f15346bd212f68463764ea8e5ee7 (diff)
downloadlibmateweather-0a8187da947344344d8c841e8c3f05b75c6f6cda.tar.bz2
libmateweather-0a8187da947344344d8c841e8c3f05b75c6f6cda.tar.xz
gtk doc: Move documentation to inline comments
-rw-r--r--configure.ac2
-rw-r--r--libmateweather/location-entry.c5
-rw-r--r--libmateweather/mateweather-location.c5
-rw-r--r--libmateweather/mateweather-prefs.c5
-rw-r--r--libmateweather/mateweather-timezone.c5
-rw-r--r--libmateweather/mateweather-xml.c5
-rw-r--r--libmateweather/timezone-menu.c5
-rw-r--r--libmateweather/weather.c5
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);