Fix ChamplainPoint gtk documentation

diff --git a/.gitignore b/.gitignore
index bcfa161ed2d756b04a72223a26dac142e3bf8f13..5b70746e1f53e1e20b9d7ffdd0fdc36fef8c4867 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -35,7 +35,13 @@ demos/launcher-gtk
 depcomp
 compile
 docs/reference-gtk/version.xml
+docs/reference-gtk/html/*.*
+docs/reference-gtk/tmpl/*.*
+docs/reference-gtk/xml/*.*
 docs/reference/version.xml
+docs/reference/html/*.*
+docs/reference/tmpl/*.*
+docs/reference/xml/*.*
 gtk-doc.make
 install-sh
 libtool

diff --git a/champlain/champlain-point.c b/champlain/champlain-point.c
index 49978908f8583d660e56512da684d0972a47db02..4f314f07e2fa7162d6aeea88d9a59fdc003ee916 100644 (file)
--- a/champlain/champlain-point.c
+++ b/champlain/champlain-point.c
@@ -19,6 +19,11 @@
  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  */
 
+/**
+ * SECTION:champlain-point
+ * @short_description: A base struct to store a latitude and longitude
+ */
+
 #include "champlain-point.h"
 
 GType
@@ -74,9 +79,10 @@ champlain_point_free (ChamplainPoint *point)
 
 /**
  * champlain_point_new:
- * @point: a #ChamplainPoint
+ * @lat: the latitude
+ * @lon: the longitude
  *
- * Frees a point structure created with champlain_point_copy().
+ * Return value: a newly allocated #ChamplainPoint to be freed with #champlain_point_free
  *
  * Since: 0.4
  */

diff --git a/champlain/champlain-point.h b/champlain/champlain-point.h
index 3356f92bca1f9f3b8c0573ba600541815f2dfab4..7cae94733f5bf5d2d8786357165b0f463260a017 100644 (file)
--- a/champlain/champlain-point.h
+++ b/champlain/champlain-point.h
@@ -25,14 +25,17 @@
 
 #include <glib-object.h>
 
-typedef struct
+typedef struct _ChamplainPoint ChamplainPoint;
+
+struct _ChamplainPoint
 {
   double lat;
   double lon;
-} ChamplainPoint;
+};
 
 GType champlain_point_get_type (void) G_GNUC_CONST;
 #define CHAMPLAIN_TYPE_POINT (champlain_point_get_type ())
+#define CHAMPLAIN_POINT(x) ((ChamplainPoint *) (x))
 
 ChamplainPoint * champlain_point_copy (const ChamplainPoint *point);
 

diff --git a/docs/reference/libchamplain-docs.sgml b/docs/reference/libchamplain-docs.sgml
index ab545a3ef2420d4ece96d189def33795a0713d58..a0ed186ef1d6251768186865d5ea3c4a8426061e 100644 (file)
--- a/docs/reference/libchamplain-docs.sgml
+++ b/docs/reference/libchamplain-docs.sgml
@@ -45,6 +45,7 @@
     <xi:include href="xml/champlain-base-marker.xml"/>
     <xi:include href="xml/champlain-marker.xml"/>
     <xi:include href="xml/champlain-polygon.xml"/>
+    <xi:include href="xml/champlain-point.xml"/>
   </chapter>
   <chapter>
     <title>II. Map Source API Reference</title>

diff --git a/docs/reference/libchamplain-sections.txt b/docs/reference/libchamplain-sections.txt
index 240611cd8818784f5df4662a64bce8be19a5f0f5..85507a7674e8cadbacc3e5aa46cb5cab4d0b3210 100644 (file)
--- a/docs/reference/libchamplain-sections.txt
+++ b/docs/reference/libchamplain-sections.txt
@@ -321,6 +321,19 @@ CHAMPLAIN_PARAM_READWRITE
 ChamplainState
 </SECTION>
 
+<SECTION>
+<FILE>champlain-point</FILE>
+<TITLE>ChamplainPoint</TITLE>
+ChamplainPoint
+champlain_point_new
+champlain_point_copy
+champlain_point_free
+<SUBSECTION Standard>
+CHAMPLAIN_POINT
+CHAMPLAIN_TYPE_POINT
+champlain_point_get_type
+</SECTION>
+
 <SECTION>
 <FILE>champlain-cache</FILE>
 <TITLE>ChamplainCache</TITLE>

diff --git a/docs/reference/libchamplain.types b/docs/reference/libchamplain.types
index d89f7917fb4297368cf1f69d5275f7dadecb7dfe..b2c526714f68b6f58d9a6ab6803ea9a53bfdb42d 100644 (file)
--- a/docs/reference/libchamplain.types
+++ b/docs/reference/libchamplain.types
@@ -10,3 +10,4 @@ champlain_tile_get_type
 champlain_cache_get_type
 champlain_map_source_factory_get_type
 champlain_polygon_get_type
+champlain_point_get_type