Fix ChamplainPolygon documentation

diff --git a/champlain/champlain-polygon.c b/champlain/champlain-polygon.c
index f2281caeab8a9cd99d9d55a4e83bd8fe7ea7fcdb..820ddffaca0c5728c93cdcefa77cdc4d6ee38569 100644 (file)
--- a/champlain/champlain-polygon.c
+++ b/champlain/champlain-polygon.c
@@ -18,13 +18,9 @@
 
 /**
  * SECTION:champlain-polygon
- * @short_description: A container for #ChamplainPolygon
+ * @short_description: A polygon to be drawn on the map
  *
- * A ChamplainPolygon is little more than a #ClutterContainer. It keeps the
- * polygons ordered so that they display correctly.
- *
- * Use #clutter_container_add to add polygons to the polygon and
- * #clutter_container_remove to remove them.
+ * A ChamplainPolygon is a set of point forming a shape on the map.  This API is based on Cairo's.
  */
 
 #include "config.h"
@@ -292,7 +288,7 @@ champlain_polygon_init (ChamplainPolygon *self)
 /**
  * champlain_polygon_new:
  *
- * Returns a new #ChamplainPolygon ready to be to draw polygons on the map
+ * Returns a new empty #ChamplainPolygon
  *
  * Since: 0.4
  */

diff --git a/champlain/champlain-view.c b/champlain/champlain-view.c
index cd8c283c5b6b02d3b7a62272a332b800329f421c..5ca635e6adf96c9131ea04f79db1cafb1582d6eb 100644 (file)
--- a/champlain/champlain-view.c
+++ b/champlain/champlain-view.c
@@ -2359,7 +2359,7 @@ champlain_view_add_polygon (ChamplainView *view,
  * @view: a #ChamplainView
  * @polygon: a #ChamplainPolygon
  *
- * Removes a #ChamplainPolygon to the #ChamplainView
+ * Removes a #ChamplainPolygon from #ChamplainView
  *
  * Since: 0.4
  */

diff --git a/docs/reference/libchamplain-docs.sgml b/docs/reference/libchamplain-docs.sgml
index 0d89f0f4c2c99c1c35eaf67d311cc92518476f60..ab545a3ef2420d4ece96d189def33795a0713d58 100644 (file)
--- a/docs/reference/libchamplain-docs.sgml
+++ b/docs/reference/libchamplain-docs.sgml
@@ -44,6 +44,7 @@
     <xi:include href="xml/champlain-layer.xml"/>
     <xi:include href="xml/champlain-base-marker.xml"/>
     <xi:include href="xml/champlain-marker.xml"/>
+    <xi:include href="xml/champlain-polygon.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 ae62f1fb5803da546fd75c445d3dcac2e2fbcd76..240611cd8818784f5df4662a64bce8be19a5f0f5 100644 (file)
--- a/docs/reference/libchamplain-sections.txt
+++ b/docs/reference/libchamplain-sections.txt
@@ -154,6 +154,8 @@ champlain_view_get_scroll_mode
 champlain_view_get_show_license
 champlain_view_get_zoom_level
 champlain_view_get_zoom_on_double_click
+champlain_view_add_polygon
+champlain_view_remove_polygon
 <SUBSECTION Standard>
 CHAMPLAIN_VIEW
 CHAMPLAIN_IS_VIEW
@@ -325,7 +327,7 @@ ChamplainState
 ChamplainCache
 ChamplainCacheClass
 champlain_cache_fill_tile
-champlain_cache_get_default
+champlain_cache_dup_default
 champlain_cache_get_size_limit
 champlain_cache_purge
 champlain_cache_purge_on_idle
@@ -348,7 +350,7 @@ CHAMPLAIN_CACHE_GET_CLASS
 ChamplainMapSourceFactory
 ChamplainMapSourceDesc
 ChamplainMapSourceConstructor
-champlain_map_source_factory_get_default
+champlain_map_source_factory_dup_default
 champlain_map_source_factory_get_list
 champlain_map_source_factory_create
 champlain_map_source_factory_register
@@ -362,3 +364,33 @@ CHAMPLAIN_IS_MAP_SOURCE_FACTORY_CLASS
 CHAMPLAIN_MAP_SOURCE_FACTORY_GET_CLASS
 </SECTION>
 
+<SECTION>
+<FILE>champlain-polygon</FILE>
+<TITLE>ChamplainPolygon</TITLE>
+ChamplainPolygon
+champlain_polygon_new
+champlain_polygon_append_point
+champlain_polygon_clear_points
+champlain_polygon_get_fill
+champlain_polygon_get_fill_color
+champlain_polygon_get_points
+champlain_polygon_get_stroke
+champlain_polygon_get_stroke_color
+champlain_polygon_get_stroke_width
+champlain_polygon_hide
+champlain_polygon_insert_point
+champlain_polygon_set_fill
+champlain_polygon_set_fill_color
+champlain_polygon_set_stroke
+champlain_polygon_set_stroke_color
+champlain_polygon_set_stroke_width
+champlain_polygon_show
+<SUBSECTION Standard>
+CHAMPLAIN_POLYGON_FACTORY
+CHAMPLAIN_IS_POLYGON
+CHAMPLAIN_TYPE_POLYGON
+champlain_polygon_get_type
+CHAMPLAIN_POLYGON_CLASS
+CHAMPLAIN_IS_POLYGON_CLASS
+CHAMPLAIN_POLYGON_GET_CLASS
+</SECTION>

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