X-Git-Url: http://pileus.org/git/?p=grits;a=blobdiff_plain;f=src%2Fobjects%2Fgis-marker.c;h=fc4beb1bf956cd0a0f2097444a4100c2ccd5f62c;hp=f3a5079a66db4b6d4f75a9e2b2bbceedaeebb181;hb=715cf80f0277fa64b45afbed5e4b27c7f4347879;hpb=2ff4eb1f35e8300a2fdfdb6d38389284d483ba1d
diff --git a/src/objects/gis-marker.c b/src/objects/gis-marker.c
index f3a5079..fc4beb1 100644
--- a/src/objects/gis-marker.c
+++ b/src/objects/gis-marker.c
@@ -15,10 +15,35 @@
* along with this program. If not, see .
*/
+/**
+ * SECTION:gis-marker
+ * @short_description: Single point markers
+ *
+ * Each #GisMarker represents some point on the earth with some form of
+ * content. Commonly this is used to mark geographic features such as cities or
+ * states.
+ *
+ * While markers represent a place in three dimensions somewhere on, below, or
+ * above the surface of the earth, they are drawn in 2 dimensions so that they
+ * look normal and readable by the user. Due to this, GisObjects should almost
+ * always be added to the GIS_LEVEL_OVERLAY level so they are drawn "above" the
+ * actual earth.
+ */
+
#include
#include "gis-marker.h"
-/* GisMarker */
+/*************
+ * GisMarker *
+ *************/
+/**
+ * gis_marker_new:
+ * @label: a short description of the marker
+ *
+ * Create a new GisMarker which shows the given label when drawn.
+ *
+ * Returns: the new #GisMarker.
+ */
GisMarker *gis_marker_new(const gchar *label)
{
//g_debug("GisMarker: new - %s", label);