Permalink
Browse files

Fixed Gtk-doc comment blocks

  • Loading branch information...
1 parent feb38f3 commit 2ebe76461c03c001001d704a15d0fdb5f542c96a @glebihan glebihan committed Jun 18, 2012
View
4 src/cinnamon-app-system.c
@@ -455,7 +455,7 @@ cinnamon_app_system_get_settings_tree (CinnamonAppSystem *self)
/**
* cinnamon_app_system_lookup_setting:
- * @self:
+ * @system:
* @id: desktop file id
*
* Returns: (transfer none): Application in gnomecc.menu, or %NULL if none
@@ -628,7 +628,7 @@ cinnamon_app_system_lookup_heuristic_basename (CinnamonAppSystem *system,
/**
* cinnamon_app_system_get_all:
- * @self:
+ * @system:
*
* Returns: (transfer container) (element-type CinnamonApp): All installed applications
*/
View
2 src/cinnamon-contact-system.c
@@ -90,7 +90,7 @@ cinnamon_contact_system_class_init (CinnamonContactSystemClass *klass)
g_type_class_add_private (object_class, sizeof (CinnamonContactSystemPrivate));
}
-/**
+/*
* normalize_terms:
* @terms: (element-type utf8): Input search terms
*
View
3 src/cinnamon-doc-system.c
@@ -52,7 +52,8 @@ cinnamon_doc_system_get_all (CinnamonDocSystem *self)
}
/**
- * @self: A #CinnamonDocSystem
+ * cinnamon_doc_system_lookup_by_uri:
+ * @system: A #CinnamonDocSystem
* @uri: Url
*
* Returns: (transfer none): Recent file info corresponding to given @uri
View
5 src/cinnamon-global.c
@@ -1158,7 +1158,7 @@ cinnamon_global_end_modal (CinnamonGlobal *global,
}
/**
- * cinnamon_global_create_pointer_barrier
+ * cinnamon_global_create_pointer_barrier:
* @global: a #CinnamonGlobal
* @x1: left X coordinate
* @y1: top Y coordinate
@@ -1189,7 +1189,7 @@ cinnamon_global_create_pointer_barrier (CinnamonGlobal *global,
}
/**
- * cinnamon_global_destroy_pointer_barrier
+ * cinnamon_global_destroy_pointer_barrier:
* @global: a #CinnamonGlobal
* @barrier: a pointer barrier
*
@@ -2143,7 +2143,6 @@ cinnamon_global_screenshot_area (CinnamonGlobal *global,
* cinnamon_global_screenshot_window:
* @global: the #CinnamonGlobal
* @include_frame: Whether to include the frame or not
- *
* @filename: The filename for the screenshot
*
* Takes a screenshot of the focused window (optionally omitting the frame)
View
2 src/cinnamon-perf-log.c
@@ -590,7 +590,7 @@ cinnamon_perf_log_update_statistic_x (CinnamonPerfLog *perf_log,
}
/**
- * cinnamon_perf_log_add statistics_callback:
+ * cinnamon_perf_log_add_statistics_callback:
* @perf_log: a #CinnamonPerfLog
* @callback: function to call before recording statistics
* @user_data: data to pass to @callback
View
2 src/cinnamon-window-tracker.c
@@ -742,7 +742,7 @@ on_focus_window_changed (MetaDisplay *display,
/**
* cinnamon_window_tracker_get_startup_sequences:
- * @self:
+ * @tracker:
*
* Returns: (transfer none) (element-type CinnamonStartupSequence): Currently active startup sequences
*/
View
10 src/cinnamon-wm.c
@@ -150,7 +150,7 @@ cinnamon_wm_completed_switch_workspace (CinnamonWM *wm)
}
/**
- * cinnamon_wm_completed_minimize
+ * cinnamon_wm_completed_minimize:
* @wm: the CinnamonWM
* @actor: the MetaWindowActor actor
*
@@ -164,7 +164,7 @@ cinnamon_wm_completed_minimize (CinnamonWM *wm,
}
/**
- * cinnamon_wm_completed_maximize
+ * cinnamon_wm_completed_maximize:
* @wm: the CinnamonWM
* @actor: the MetaWindowActor actor
*
@@ -178,7 +178,7 @@ cinnamon_wm_completed_maximize (CinnamonWM *wm,
}
/**
- * cinnamon_wm_completed_unmaximize
+ * cinnamon_wm_completed_unmaximize:
* @wm: the CinnamonWM
* @actor: the MetaWindowActor actor
*
@@ -192,7 +192,7 @@ cinnamon_wm_completed_unmaximize (CinnamonWM *wm,
}
/**
- * cinnamon_wm_completed_map
+ * cinnamon_wm_completed_map:
* @wm: the CinnamonWM
* @actor: the MetaWindowActor actor
*
@@ -206,7 +206,7 @@ cinnamon_wm_completed_map (CinnamonWM *wm,
}
/**
- * cinnamon_wm_completed_destroy
+ * cinnamon_wm_completed_destroy:
* @wm: the CinnamonWM
* @actor: the MetaWindowActor actor
*
View
2 src/st/st-adjustment.h
@@ -57,7 +57,7 @@ struct _StAdjustment
};
/**
- * StAdjustmentClass
+ * StAdjustmentClass:
* @changed: Class handler for the ::changed signal.
*
* Base class for #StAdjustment.
View
3 src/st/st-texture-cache.c
@@ -336,7 +336,6 @@ icon_lookup_data_destroy (gpointer p)
/**
* on_image_size_prepared:
- *
* @pixbuf_loader: #GdkPixbufLoader loading the image
* @width: the original width of the image
* @height: the original height of the image
@@ -1559,7 +1558,6 @@ st_texture_cache_load_icon_name (StTextureCache *cache,
/**
* st_texture_cache_load_uri_async:
- *
* @cache: The texture cache instance
* @uri: uri of the image file from which to create a pixbuf
* @available_width: available width for the image, can be -1 if not limited
@@ -1674,7 +1672,6 @@ st_texture_cache_load_uri_sync_to_cairo_surface (StTextureCache *cache,
/**
* st_texture_cache_load_uri_sync:
- *
* @cache: The texture cache instance
* @policy: Requested lifecycle of cached data
* @uri: uri of the image file from which to create a pixbuf
View
6 src/st/st-theme.c
@@ -490,7 +490,7 @@ pseudo_class_add_sel_matches_style (StTheme *a_this,
return string_in_list (a_add_sel->content.pseudo->name->stryng, node_pseudo_class);
}
-/**
+/*
*@param a_add_sel the class additional selector to consider.
*@param a_node the style node to consider.
*@return TRUE if the class additional selector matches
@@ -516,7 +516,7 @@ class_add_sel_matches_style (CRAdditionalSel *a_add_sel,
return string_in_list (a_add_sel->content.class_name->stryng, element_class);
}
-/**
+/*
*@return TRUE if the additional attribute selector matches
*the current style node given in argument, FALSE otherwise.
*@param a_add_sel the additional attribute selector to consider.
@@ -614,7 +614,7 @@ element_name_matches_type (const char *element_name,
}
}
-/**
+/*
*Evaluate a selector (a simple selectors list) and says
*if it matches the style node given in parameter.
*The algorithm used here is the following:
View
14 src/st/st-types.h
@@ -15,13 +15,6 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
-/**
- * SECTION:st-types
- * @short_description: type definitions used throughout St
- *
- * Common types for StWidgets.
- */
-
#if !defined(ST_H_INSIDE) && !defined(ST_COMPILATION)
#error "Only <st/st.h> can be included directly.h"
@@ -36,6 +29,13 @@
G_BEGIN_DECLS
+/**
+ * SECTION:st-types
+ * @short_description: type definitions used throughout St
+ *
+ * Common types for StWidgets.
+ */
+
typedef enum {
ST_ALIGN_START,
ST_ALIGN_MIDDLE,
View
5 src/st/st-widget.c
@@ -866,7 +866,7 @@ st_widget_class_init (StWidgetClass *klass)
ST_PARAM_READWRITE));
/**
- * StWidget:theme
+ * StWidget:theme:
*
* A theme set on this actor overriding the global theming for this actor
* and its descendants
@@ -2133,7 +2133,6 @@ st_describe_actor (ClutterActor *actor)
/**
* st_set_slow_down_factor:
- *
* @factor: new slow-down factor
*
* Set a global factor applied to all animation durations
@@ -2441,7 +2440,7 @@ st_ui_root_destroyed (ClutterActor *actor,
}
/**
- * st_get_ui_root:
+ * st_set_ui_root:
* @stage: a #ClutterStage
* @container: (allow-none): the new UI root
*

0 comments on commit 2ebe764

Please sign in to comment.