Commit 36c2db60 authored by Marcus Lundblad's avatar Marcus Lundblad
Browse files

Remove Since tags

We're starting the version numbering afresh,
so all API is present from the start.
parent e2144c66
......@@ -55,8 +55,6 @@ shumate_bounding_box_get_type (void)
* with shumate_bounding_box_free().
*
* Returns: a #ShumateBoundingBox
*
* Since: 0.6
*/
ShumateBoundingBox *
shumate_bounding_box_new (void)
......@@ -82,8 +80,6 @@ shumate_bounding_box_new (void)
* freed using shumate_bounding_box_free().
*
* Returns: an allocated copy of @bbox.
*
* Since: 0.6
*/
ShumateBoundingBox *
shumate_bounding_box_copy (const ShumateBoundingBox *bbox)
......@@ -101,8 +97,6 @@ shumate_bounding_box_copy (const ShumateBoundingBox *bbox)
*
* Frees a bounding box structure created with shumate_bounding_box_new() or
* shumate_bounding_box_copy().
*
* Since: 0.6
*/
void
shumate_bounding_box_free (ShumateBoundingBox *bbox)
......@@ -121,8 +115,6 @@ shumate_bounding_box_free (ShumateBoundingBox *bbox)
* @longitude: (out): the longitude of the box center
*
* Gets the center's latitude and longitude of the box to @latitude and @longitude.
*
* Since: 0.6
*/
void
shumate_bounding_box_get_center (ShumateBoundingBox *bbox,
......@@ -142,8 +134,6 @@ shumate_bounding_box_get_center (ShumateBoundingBox *bbox,
* @other: a #ShumateBoundingBox
*
* Sets bbox equal to the bounding box containing both @bbox and @other.
*
* Since: 0.10
*/
void
shumate_bounding_box_compose (ShumateBoundingBox *bbox,
......@@ -173,8 +163,6 @@ shumate_bounding_box_compose (ShumateBoundingBox *bbox,
*
* Extend the bounding box so it contains a point with @latitude and @longitude.
* Do nothing if the point is already inside the bounding box.
*
* Since: 0.10
*/
void
shumate_bounding_box_extend (ShumateBoundingBox *bbox,
......@@ -203,8 +191,6 @@ shumate_bounding_box_extend (ShumateBoundingBox *bbox,
* Checks whether @bbox represents a valid bounding box on the map.
*
* Returns: TRUE when the bounding box is valid, FALSE otherwise.
*
* Since: 0.10
*/
gboolean
shumate_bounding_box_is_valid (ShumateBoundingBox *bbox)
......@@ -227,8 +213,6 @@ shumate_bounding_box_is_valid (ShumateBoundingBox *bbox)
* Checks whether @bbox covers the given coordinates.
*
* Returns: TRUE when the bounding box covers given coordinates, FALSE otherwise.
*
* Since: 0.12.4
*/
gboolean
shumate_bounding_box_covers(ShumateBoundingBox *bbox,
......
......@@ -40,8 +40,6 @@ typedef struct _ShumateBoundingBox ShumateBoundingBox;
* @bottom: bottom coordinate
*
* Defines the area of a ShumateMapDataSource that contains data.
*
* Since: 0.6
*/
struct _ShumateBoundingBox
{
......
......@@ -216,8 +216,6 @@ shumate_coordinate_init (ShumateCoordinate *coordinate)
* Creates a new instance of #ShumateCoordinate.
*
* Returns: the created instance.
*
* Since: 0.10
*/
ShumateCoordinate *
shumate_coordinate_new ()
......@@ -235,8 +233,6 @@ shumate_coordinate_new ()
* coordinates.
*
* Returns: the created instance.
*
* Since: 0.10
*/
ShumateCoordinate *
shumate_coordinate_new_full (gdouble latitude,
......
......@@ -59,8 +59,6 @@ typedef struct _ShumateCoordinateClass ShumateCoordinateClass;
*
* The #ShumateCoordinate structure contains only private data
* and should be accessed using the provided API
*
* Since: 0.10
*/
struct _ShumateCoordinate
{
......
......@@ -132,8 +132,6 @@ shumate_error_tile_renderer_class_init (ShumateErrorTileRendererClass *klass)
* ShumateErrorTileRenderer:tile-size:
*
* The size of the rendered tile.
*
* Since: 0.8
*/
g_object_class_install_property (object_class,
PROP_TILE_SIZE,
......@@ -168,8 +166,6 @@ shumate_error_tile_renderer_init (ShumateErrorTileRenderer *self)
* Constructor of a #ShumateErrorTileRenderer.
*
* Returns: a constructed #ShumateErrorTileRenderer
*
* Since: 0.8
*/
ShumateErrorTileRenderer *
shumate_error_tile_renderer_new (guint tile_size)
......@@ -270,8 +266,6 @@ render (ShumateRenderer *renderer, ShumateTile *tile)
* @size: the size of the rendered error tiles
*
* Sets the size of the rendered error tile.
*
* Since: 0.8
*/
void
shumate_error_tile_renderer_set_tile_size (ShumateErrorTileRenderer *renderer,
......@@ -292,8 +286,6 @@ shumate_error_tile_renderer_set_tile_size (ShumateErrorTileRenderer *renderer,
* Gets the size of the rendered error tiles.
*
* Returns: the size of the rendered error tiles
*
* Since: 0.8
*/
guint
shumate_error_tile_renderer_get_tile_size (ShumateErrorTileRenderer *renderer)
......
......@@ -56,8 +56,6 @@ typedef struct _ShumateErrorTileRendererClass ShumateErrorTileRendererClass;
*
* The #ShumateErrorTileRenderer structure contains only private data
* and should be accessed using the provided API
*
* Since: 0.8
*/
struct _ShumateErrorTileRenderer
{
......
......@@ -40,8 +40,6 @@ shumate_exportable_default_init (ShumateExportableInterface *iface)
* ShumateExportable:surface:
*
* A #cairo_surface_t representation
*
* Since: 0.12.12
*/
g_object_interface_install_property (iface,
g_param_spec_boxed ("surface",
......@@ -58,8 +56,6 @@ shumate_exportable_default_init (ShumateExportableInterface *iface)
* @surface: the #cairo_surface_t
*
* Set a #cairo_surface_t to be associated with this tile.
*
* Since: 0.12.12
*/
void
shumate_exportable_set_surface (ShumateExportable *exportable,
......@@ -79,8 +75,6 @@ shumate_exportable_set_surface (ShumateExportable *exportable,
* Gets the surface
*
* Returns: (transfer none): the #cairo_surface_t of the object
*
* Since: 0.12.12
*/
cairo_surface_t *
shumate_exportable_get_surface (ShumateExportable *exportable)
......
......@@ -315,8 +315,6 @@ shumate_file_cache_class_init (ShumateFileCacheClass *klass)
* The cache size limit in bytes.
*
* Note: this new value will not be applied until you call shumate_file_cache_purge()
*
* Since: 0.4
*/
pspec = g_param_spec_uint ("size-limit",
"Size Limit",
......@@ -331,8 +329,6 @@ shumate_file_cache_class_init (ShumateFileCacheClass *klass)
* ShumateFileCache:cache-dir:
*
* The directory where the tile database is stored.
*
* Since: 0.6
*/
pspec = g_param_spec_string ("cache-dir",
"Cache Directory",
......@@ -375,8 +371,6 @@ shumate_file_cache_init (ShumateFileCache *file_cache)
* Constructor of #ShumateFileCache.
*
* Returns: a constructed #ShumateFileCache
*
* Since: 0.8
*/
ShumateFileCache *
shumate_file_cache_new_full (guint size_limit,
......@@ -401,8 +395,6 @@ shumate_file_cache_new_full (guint size_limit,
* Gets the cache size limit in bytes.
*
* Returns: size limit
*
* Since: 0.4
*/
guint
shumate_file_cache_get_size_limit (ShumateFileCache *file_cache)
......@@ -420,8 +412,6 @@ shumate_file_cache_get_size_limit (ShumateFileCache *file_cache)
* Gets the directory where the cache database is stored.
*
* Returns: the directory
*
* Since: 0.6
*/
const gchar *
shumate_file_cache_get_cache_dir (ShumateFileCache *file_cache)
......@@ -438,8 +428,6 @@ shumate_file_cache_get_cache_dir (ShumateFileCache *file_cache)
* @size_limit: the cache limit in bytes
*
* Sets the cache size limit in bytes.
*
* Since: 0.4
*/
void
shumate_file_cache_set_size_limit (ShumateFileCache *file_cache,
......@@ -912,8 +900,6 @@ purge_on_idle (gpointer data)
*
* Purge the cache from the less popular tiles until cache's size limit is reached.
* This is a non blocking call as the purge will happen when the application is idle
*
* Since: 0.4
*/
void
shumate_file_cache_purge_on_idle (ShumateFileCache *file_cache)
......@@ -931,8 +917,6 @@ shumate_file_cache_purge_on_idle (ShumateFileCache *file_cache)
* @file_cache: a #ShumateFileCache
*
* Purge the cache from the less popular tiles until cache's size limit is reached.
*
* Since: 0.4
*/
void
shumate_file_cache_purge (ShumateFileCache *file_cache)
......
......@@ -57,8 +57,6 @@ typedef struct _ShumateFileCacheClass ShumateFileCacheClass;
*
* The #ShumateFileCache structure contains only private data
* and should be accessed using the provided API
*
* Since: 0.6
*/
struct _ShumateFileCache
{
......
......@@ -108,8 +108,6 @@ shumate_image_renderer_init (ShumateImageRenderer *self)
* Constructor of #ShumateImageRenderer.
*
* Returns: a constructed #ShumateImageRenderer object
*
* Since: 0.8
*/
ShumateImageRenderer *
shumate_image_renderer_new (void)
......
......@@ -56,8 +56,6 @@ typedef struct _ShumateImageRendererClass ShumateImageRendererClass;
*
* The #ShumateImageRenderer structure contains only private data
* and should be accessed using the provided API
*
* Since: 0.8
*/
struct _ShumateImageRenderer
{
......
......@@ -369,8 +369,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:text:
*
* The text of the label
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_TEXT,
g_param_spec_string ("text",
......@@ -383,8 +381,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:image:
*
* The image of the label
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_IMAGE,
g_param_spec_object ("image",
......@@ -397,8 +393,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:use-markup:
*
* If the label's text uses markup
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_USE_MARKUP,
g_param_spec_boolean ("use-markup",
......@@ -411,8 +405,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:alignment:
*
* The label's alignment
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_ALIGNMENT,
g_param_spec_enum ("alignment",
......@@ -426,8 +418,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:color:
*
* The label's color
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_COLOR,
clutter_param_spec_color ("color",
......@@ -440,8 +430,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:text-color:
*
* The label's text color
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_TEXT_COLOR,
clutter_param_spec_color ("text-color",
......@@ -454,8 +442,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:font-name:
*
* The label's text font name
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_FONT_NAME,
g_param_spec_string ("font-name",
......@@ -468,8 +454,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:wrap:
*
* If the label's text wrap is set
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_WRAP,
g_param_spec_boolean ("wrap",
......@@ -482,8 +466,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:wrap-mode:
*
* The label's text wrap mode
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_WRAP_MODE,
g_param_spec_enum ("wrap-mode",
......@@ -497,8 +479,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:ellipsize:
*
* The label's ellipsize mode
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_ELLIPSIZE,
g_param_spec_enum ("ellipsize",
......@@ -512,8 +492,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:draw-background:
*
* If the label has a background
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_DRAW_BACKGROUND,
g_param_spec_boolean ("draw-background",
......@@ -526,8 +504,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:draw-shadow:
*
* If the label background has a shadow
*
* Since: 0.12.10
*/
g_object_class_install_property (object_class, PROP_DRAW_SHADOW,
g_param_spec_boolean ("draw-shadow",
......@@ -540,8 +516,6 @@ shumate_label_class_init (ShumateLabelClass *klass)
* ShumateLabel:single-line-mode:
*
* If the label is in single line mode
*
* Since: 0.10
*/
g_object_class_install_property (object_class, PROP_SINGLE_LINE_MODE,
g_param_spec_boolean ("single-line-mode",
......@@ -817,8 +791,6 @@ redraw_on_idle (gpointer gobject)
* be used unless you are subclassing ShumateLabel and adding new properties
* that affect the aspect of the label. When they change, call this function
* to update the label.
*
* Since: 0.10
*/
static void
shumate_label_queue_redraw (ShumateLabel *label)
......@@ -881,8 +853,6 @@ shumate_label_init (ShumateLabel *label)
* Creates a new instance of #ShumateLabel.
*
* Returns: a new #ShumateLabel ready to be used as a #ClutterActor.
*
* Since: 0.10
*/
ClutterActor *
shumate_label_new (void)
......@@ -901,8 +871,6 @@ shumate_label_new (void)
* Creates a new instance of #ShumateLabel with text value.
*
* Returns: a new #ShumateLabel with a drawn label containing the given text.
*
* Since: 0.10
*/
ClutterActor *
shumate_label_new_with_text (const gchar *text,
......@@ -935,8 +903,6 @@ shumate_label_new_with_text (const gchar *text,
*
* Returns: a new #ShumateLabel with a drawn label containing the given
* image.
*
* Since: 0.10
*/
ClutterActor *
shumate_label_new_with_image (ClutterActor *actor)
......@@ -959,8 +925,6 @@ shumate_label_new_with_image (ClutterActor *actor)
*
* Returns: a new #ShumateLabel with a drawn label containing the given
* image.
*
* Since: 0.10
*/
ClutterActor *
shumate_label_new_from_file (const gchar *filename,
......@@ -1014,8 +978,6 @@ shumate_label_new_from_file (const gchar *filename,
*
* Returns: a new #ShumateLabel with a drawn label containing the given
* image.
*
* Since: 0.10
*/
ClutterActor *
shumate_label_new_full (const gchar *text,
......@@ -1039,8 +1001,6 @@ shumate_label_new_full (const gchar *text,
* @text: The new text of the label
*
* Sets the label's text.
*
* Since: 0.10
*/
void
shumate_label_set_text (ShumateLabel *label,
......@@ -1065,8 +1025,6 @@ shumate_label_set_text (ShumateLabel *label,
* @image: (allow-none): The image as a @ClutterActor or NULL to remove the current image.
*
* Sets the label's image.
*
* Since: 0.10
*/
void
shumate_label_set_image (ShumateLabel *label,
......@@ -1098,8 +1056,6 @@ shumate_label_set_image (ShumateLabel *label,
* @use_markup: The value
*
* Sets if the label's text uses markup.
*
* Since: 0.10
*/
void
shumate_label_set_use_markup (ShumateLabel *label,
......@@ -1119,8 +1075,6 @@ shumate_label_set_use_markup (ShumateLabel *label,
* @alignment: The label's alignment
*
* Sets the label's text alignment.
*
* Since: 0.10
*/
void
shumate_label_set_alignment (ShumateLabel *label,
......@@ -1141,8 +1095,6 @@ shumate_label_set_alignment (ShumateLabel *label,
* default color. The color parameter is copied.
*
* Sets the label's background color.
*
* Since: 0.10
*/
void
shumate_label_set_color (ShumateLabel *label,
......@@ -1171,8 +1123,6 @@ shumate_label_set_color (ShumateLabel *label,
* color. The color parameter is copied.
*
* Sets the label's text color.
*
* Since: 0.10
*/
void
shumate_label_set_text_color (ShumateLabel *label,
......@@ -1201,8 +1151,6 @@ shumate_label_set_text_color (ShumateLabel *label,
* value.
*
* Sets the label's font name such as "Sans 12".
*
* Since: 0.10
*/
void
shumate_label_set_font_name (ShumateLabel *label,
......@@ -1230,8 +1178,6 @@ shumate_label_set_font_name (ShumateLabel *label,
* @wrap: The label's wrap.
*
* Sets if the label's text wrap.
*
* Since: 0.10
*/
void
shumate_label_set_wrap (ShumateLabel *label,
......@@ -1251,8 +1197,6 @@ shumate_label_set_wrap (ShumateLabel *label,
* @wrap_mode: The label's wrap mode.
*
* Sets the label's text wrap mode.
*
* Since: 0.10
*/
void
shumate_label_set_wrap_mode (ShumateLabel *label,
......@@ -1272,8 +1216,6 @@ shumate_label_set_wrap_mode (ShumateLabel *label,
* @list: The label's text attributes.
*
* Sets the label's text attributes.
*
* Since: 0.10
*/
void
shumate_label_set_attributes (ShumateLabel *label,
......@@ -1302,8 +1244,6 @@ shumate_label_set_attributes (ShumateLabel *label,
* @mode: The label's ellipsize mode.
*
* Sets the label's text ellipsize mode.
*
* Since: 0.10
*/
void
shumate_label_set_ellipsize (ShumateLabel *label,
......@@ -1323,8 +1263,6 @@ shumate_label_set_ellipsize (ShumateLabel *label,
* @mode: The label's single line mode
*
* Sets if the label's text is on a single line.
*
* Since: 0.10
*/
void
shumate_label_set_single_line_mode (ShumateLabel *label,
......@@ -1345,8 +1283,6 @@ shumate_label_set_single_line_mode (ShumateLabel *label,
* @background: value.
*
* Sets if the label has a background.
*
* Since: 0.10
*/
void
shumate_label_set_draw_background (ShumateLabel *label,
......@@ -1366,8 +1302,6 @@ shumate_label_set_draw_background (ShumateLabel *label,
* @shadow: value.
*
* Sets if the label's background has a shadow.
*
* Since: 0.12.10
*/
void
shumate_label_set_draw_shadow (ShumateLabel *label,
......@@ -1387,8 +1321,6 @@ shumate_label_set_draw_shadow (ShumateLabel *label,
* Get the label's image.
*
* Returns: (transfer none): the label's image.
*
* Since: 0.10
*/
ClutterActor *
shumate_label_get_image (ShumateLabel *label)
......@@ -1406,8 +1338,6 @@ shumate_label_get_image (ShumateLabel *label)
* Check whether the label uses markup.
*
* Returns: if the label's text contains markup.
*
* Since: 0.10
*/
gboolean
shumate_label_get_use_markup (ShumateLabel *label)
......@@ -1425,8 +1355,6 @@ shumate_label_get_use_markup (ShumateLabel *label)
* Get the label's text.
*
* Returns: the label's text.
*
* Since: 0.10
*/
const gchar *
shumate_label_get_text (ShumateLabel *label)
......@@ -1444,8 +1372,6 @@ shumate_label_get_text (ShumateLabel *label)
* Get the label's text alignment.
*
* Returns: the label's text alignment.
*
* Since: 0.10
*/
PangoAlignment
shumate_label_get_alignment (ShumateLabel *label)
......@@ -1463,8 +1389,6 @@ shumate_label_get_alignment (ShumateLabel *label)
* Gets the label's background color.
*
* Returns: the label's background color.
*
* Since: 0.10
*/
ClutterColor *
shumate_label_get_color (ShumateLabel *label)
......@@ -1482,8 +1406,6 @@ shumate_label_get_color (ShumateLabel *label)
* Gets the label's text color.
*
* Returns: the label's text color.
*
* Since: 0.10
*/
ClutterColor *
shumate_label_get_text_color (ShumateLabel *label)
......@@ -1501,8 +1423,6 @@ shumate_label_get_text_color (ShumateLabel *label)
* Gets the label's font name.
*
* Returns: the label's font name.
*
* Since: 0.10
*/
const gchar *
shumate_label_get_font_name (ShumateLabel *label)
......@@ -1520,8 +1440,6 @@ shumate_label_get_font_name (ShumateLabel *label)
* Checks whether the label text wraps.
*
* Returns: if the label's text wraps.
*
* Since: 0.10
*/
gboolean
shumate_label_get_wrap (ShumateLabel *label)
......@@ -1539,8 +1457,6 @@ shumate_label_get_wrap (ShumateLabel *label)
* Gets the label's text wrap mode.
*
* Returns: the label's text wrap mode.
*
* Since: 0.10
*/
PangoWrapMode
shumate_label_get_wrap_mode (ShumateLabel *label)
......@@ -1558,8 +1474,6 @@ shumate_label_get_wrap_mode (ShumateLabel *label)
* Gets the label's text ellipsize mode.
*
* Returns: the label's text ellipsize mode.
*
* Since: 0.10
*/
PangoEllipsizeMode
shumate_label_get_ellipsize (ShumateLabel *label)
......@@ -1577,8 +1491,6 @@ shumate_label_get_ellipsize (ShumateLabel *label)
* Checks the label's single line mode.
*
* Returns: the label's text single line mode.
*
* Since: 0.10
*/
gboolean
shumate_label_get_single_line_mode (ShumateLabel *label)
......@@ -1596,8 +1508,6 @@ shumate_label_get_single_line_mode (ShumateLabel *label)
* Checks whether the label has a background.
*
* Returns: if the label has a background.
*
* Since: 0.10
*/
gboolean