[glib] Add since tags
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib] Add since tags
- Date: Sun, 11 Dec 2011 01:47:41 +0000 (UTC)
commit f109415d950edae973ca630046deb7aebf3c8ddd
Author: Matthias Clasen <mclasen redhat com>
Date: Sat Dec 10 20:47:22 2011 -0500
Add since tags
gio/gdbusactiongroup.c | 4 +-
gio/gdbusmenumodel.c | 5 ++-
gio/gmenu.c | 102 ++++++++++++++++++++++++++++++++++++-----------
gio/gmenuexporter.c | 4 +-
gio/gmenumarkup.c | 16 ++++++--
gio/gmenumodel.c | 68 +++++++++++++++++++++++--------
6 files changed, 150 insertions(+), 49 deletions(-)
---
diff --git a/gio/gdbusactiongroup.c b/gio/gdbusactiongroup.c
index fce64e5..e7c9463 100644
--- a/gio/gdbusactiongroup.c
+++ b/gio/gdbusactiongroup.c
@@ -454,7 +454,9 @@ g_dbus_action_group_iface_init (GActionGroupInterface *iface)
* g_action_group_list_actions() to get the initial list.
*
* Returns: (transfer full): a #GDBusActionGroup
- **/
+ *
+ * Since: 2.32
+ */
GDBusActionGroup *
g_dbus_action_group_get (GDBusConnection *connection,
const gchar *bus_name,
diff --git a/gio/gdbusmenumodel.c b/gio/gdbusmenumodel.c
index 242f8ba..f82569e 100644
--- a/gio/gdbusmenumodel.c
+++ b/gio/gdbusmenumodel.c
@@ -860,7 +860,10 @@ g_dbus_menu_model_get_from_group (GDBusMenuGroup *group,
* (and linked models) must also originate from this same context, with
* the thread default main context unchanged.
*
- * Returns: (transfer full): a #GDBusMenuModel object. Free with g_object_unref().
+ * Returns: (transfer full): a #GDBusMenuModel object. Free with
+ * g_object_unref().
+ *
+ * Since: 2.32
*/
GDBusMenuModel *
g_dbus_menu_model_get (GDBusConnection *connection,
diff --git a/gio/gmenu.c b/gio/gmenu.c
index a4131ed..d98c753 100644
--- a/gio/gmenu.c
+++ b/gio/gmenu.c
@@ -146,7 +146,9 @@ g_menu_get_item_links (GMenuModel *model,
* See g_menu_insert(), g_menu_insert_section() and
* g_menu_insert_submenu() as well as "prepend" and "append" variants of
* each of these functions.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert_item (GMenu *menu,
gint position,
@@ -176,7 +178,9 @@ g_menu_insert_item (GMenu *menu,
* Prepends @item to the start of @menu.
*
* See g_menu_insert_item() for more information.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend_item (GMenu *menu,
GMenuItem *item)
@@ -192,7 +196,9 @@ g_menu_prepend_item (GMenu *menu,
* Appends @item to the end of @menu.
*
* See g_menu_insert_item() for more information.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append_item (GMenu *menu,
GMenuItem *item)
@@ -212,7 +218,9 @@ g_menu_append_item (GMenu *menu,
*
* This function causes g_menu_model_is_mutable() to begin returning
* %FALSE, which has some positive performance implications.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_freeze (GMenu *menu)
{
@@ -229,7 +237,9 @@ g_menu_freeze (GMenu *menu)
* The new menu has no items.
*
* Returns: a new #GMenu
- **/
+ *
+ * Since: 2.32
+ */
GMenu *
g_menu_new (void)
{
@@ -246,7 +256,9 @@ g_menu_new (void)
* Convenience function for inserting a normal menu item into @menu.
* Combine g_menu_new() and g_menu_insert_item() for a more flexible
* alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert (GMenu *menu,
gint position,
@@ -269,7 +281,9 @@ g_menu_insert (GMenu *menu,
* Convenience function for prepending a normal menu item to the start
* of @menu. Combine g_menu_new() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend (GMenu *menu,
const gchar *label,
@@ -287,7 +301,9 @@ g_menu_prepend (GMenu *menu,
* Convenience function for appending a normal menu item to the end of
* @menu. Combine g_menu_new() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append (GMenu *menu,
const gchar *label,
@@ -306,7 +322,9 @@ g_menu_append (GMenu *menu,
* Convenience function for inserting a section menu item into @menu.
* Combine g_menu_new_section() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert_section (GMenu *menu,
gint position,
@@ -330,7 +348,9 @@ g_menu_insert_section (GMenu *menu,
* Convenience function for prepending a section menu item to the start
* of @menu. Combine g_menu_new_section() and g_menu_insert_item() for
* a more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend_section (GMenu *menu,
const gchar *label,
@@ -348,7 +368,9 @@ g_menu_prepend_section (GMenu *menu,
* Convenience function for appending a section menu item to the end of
* @menu. Combine g_menu_new_section() and g_menu_insert_item() for a
* more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append_section (GMenu *menu,
const gchar *label,
@@ -367,7 +389,9 @@ g_menu_append_section (GMenu *menu,
* Convenience function for inserting a submenu menu item into @menu.
* Combine g_menu_new_submenu() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert_submenu (GMenu *menu,
gint position,
@@ -390,7 +414,9 @@ g_menu_insert_submenu (GMenu *menu,
* Convenience function for prepending a submenu menu item to the start
* of @menu. Combine g_menu_new_submenu() and g_menu_insert_item() for
* a more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend_submenu (GMenu *menu,
const gchar *label,
@@ -408,7 +434,9 @@ g_menu_prepend_submenu (GMenu *menu,
* Convenience function for appending a submenu menu item to the end of
* @menu. Combine g_menu_new_submenu() and g_menu_insert_item() for a
* more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append_submenu (GMenu *menu,
const gchar *label,
@@ -441,7 +469,9 @@ g_menu_clear_item (struct item *item)
* It is not possible to remove items by identity since items are added
* to the menu simply by copying their links and attributes (ie:
* identity of the item itself is not preserved).
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_remove (GMenu *menu,
gint position)
@@ -608,7 +638,9 @@ valid_attribute_name (const gchar *name)
*
* See also g_menu_item_set_attribute() for a more convenient way to do
* the same.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_attribute_value (GMenuItem *menu_item,
const gchar *attribute,
@@ -650,7 +682,9 @@ g_menu_item_set_attribute_value (GMenuItem *menu_item,
*
* See also g_menu_item_set_attribute_value() for an equivalent call
* that directly accepts a #GVariant.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_attribute (GMenuItem *menu_item,
const gchar *attribute,
@@ -689,6 +723,8 @@ g_menu_item_set_attribute (GMenuItem *menu_item,
* Link types are restricted to lowercase characters, numbers
* and '-'. Furthermore, the names must begin with a lowercase character,
* must not end with a '-', and must not contain consecutive dashes.
+ *
+ * Since: 2.32
*/
void
g_menu_item_set_link (GMenuItem *menu_item,
@@ -716,7 +752,9 @@ g_menu_item_set_link (GMenuItem *menu_item,
*
* If @label is non-%NULL it is used as the label for the menu item. If
* it is %NULL then the label attribute is unset.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_label (GMenuItem *menu_item,
const gchar *label)
@@ -743,7 +781,9 @@ g_menu_item_set_label (GMenuItem *menu_item,
*
* The effect of having one menu appear as a submenu of another is
* exactly as it sounds.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_submenu (GMenuItem *menu_item,
GMenuModel *submenu)
@@ -763,7 +803,9 @@ g_menu_item_set_submenu (GMenuItem *menu_item,
* the menu that @menu_item is added to. See g_menu_item_new_section()
* for more information about what it means for a menu item to be a
* section.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_section (GMenuItem *menu_item,
GMenuModel *section)
@@ -813,6 +855,8 @@ g_menu_item_set_section (GMenuItem *menu_item,
* See g_menu_item_set_action_and_target() or
* g_menu_item_set_detailed_action() for two equivalent calls that are
* probably more convenient for most uses.
+ *
+ * Since: 2.32
*/
void
g_menu_item_set_action_and_target_value (GMenuItem *menu_item,
@@ -861,6 +905,8 @@ g_menu_item_set_action_and_target_value (GMenuItem *menu_item,
*
* See also g_menu_item_set_action_and_target_value() for a
* description of the semantics of the action and target attributes.
+ *
+ * Since: 2.32
*/
void
g_menu_item_set_action_and_target (GMenuItem *menu_item,
@@ -907,7 +953,9 @@ g_menu_item_set_action_and_target (GMenuItem *menu_item,
*
* See also g_menu_set_action_and_target_value() for a description of
* the semantics of the action and target attributes.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_detailed_action (GMenuItem *menu_item,
const gchar *detailed_action)
@@ -944,7 +992,9 @@ g_menu_item_set_detailed_action (GMenuItem *menu_item,
* g_menu_item_set_detailed_action() for more information.
*
* Returns: a new #GMenuItem
- **/
+ *
+ * Since: 2.32
+ */
GMenuItem *
g_menu_item_new (const gchar *label,
const gchar *detailed_action)
@@ -973,7 +1023,9 @@ g_menu_item_new (const gchar *label,
* g_menu_item_set_submenu().
*
* Returns: a new #GMenuItem
- **/
+ *
+ * Since: 2.32
+ */
GMenuItem *
g_menu_item_new_submenu (const gchar *label,
GMenuModel *submenu)
@@ -1059,7 +1111,9 @@ g_menu_item_new_submenu (const gchar *label,
* ]]></programlisting></informalexample>
*
* Returns: a new #GMenuItem
- **/
+ *
+ * Since: 2.32
+ */
GMenuItem *
g_menu_item_new_section (const gchar *label,
GMenuModel *section)
diff --git a/gio/gmenuexporter.c b/gio/gmenuexporter.c
index f0647bd..ca771c0 100644
--- a/gio/gmenuexporter.c
+++ b/gio/gmenuexporter.c
@@ -837,6 +837,8 @@ g_menu_exporter_method_call (GDBusConnection *connection,
* this function.
*
* Returns: the ID of the export (never zero), or 0 in case of failure
+ *
+ * Since: 2.32
*/
guint
g_dbus_connection_export_menu_model (GDBusConnection *connection,
@@ -883,7 +885,7 @@ g_dbus_connection_export_menu_model (GDBusConnection *connection,
* same ID more than once.
*
* Since: 2.32
- **/
+ */
void
g_dbus_connection_unexport_menu_model (GDBusConnection *connection,
guint export_id)
diff --git a/gio/gmenumarkup.c b/gio/gmenumarkup.c
index 24a2dfb..5d6849f 100644
--- a/gio/gmenumarkup.c
+++ b/gio/gmenumarkup.c
@@ -440,6 +440,8 @@ static GMarkupParser g_menu_subparser =
* the element representing the group containing the menus. In other
* words, the content inside of this element is expected to be a list of
* menus.
+ *
+ * Since: 2.32
*/
void
g_menu_markup_parser_start (GMarkupParseContext *context,
@@ -476,7 +478,9 @@ g_menu_markup_parser_start (GMarkupParseContext *context,
* See that function for more information
*
* Returns: (transfer full): the #GHashTable containing the objects
- **/
+ *
+ * Since: 2.32
+ */
GHashTable *
g_menu_markup_parser_end (GMarkupParseContext *context)
{
@@ -517,7 +521,9 @@ g_menu_markup_parser_end (GMarkupParseContext *context)
* You should call g_menu_markup_parser_end_menu() from the
* corresponding end_element function in order to collect the newly
* parsed menu.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_markup_parser_start_menu (GMarkupParseContext *context,
const gchar *domain,
@@ -549,7 +555,9 @@ g_menu_markup_parser_start_menu (GMarkupParseContext *context,
* See that function for more information
*
* Returns: (transfer full): the newly-created #GMenu
- **/
+ *
+ * Since: 2.32
+ */
GMenu *
g_menu_markup_parser_end_menu (GMarkupParseContext *context)
{
@@ -703,7 +711,7 @@ g_menu_markup_print_string (GString *string,
* Print @model to stderr for debugging purposes.
*
* This debugging function will be removed in the future.
- **/
+ */
void
g_menu_markup_print_stderr (GMenuModel *model)
{
diff --git a/gio/gmenumodel.c b/gio/gmenumodel.c
index e5737b3..8d97b95 100644
--- a/gio/gmenumodel.c
+++ b/gio/gmenumodel.c
@@ -460,8 +460,10 @@ g_menu_model_class_init (GMenuModelClass *class)
* signal. Consumers of the model may make optimisations accordingly.
*
* Returns: %TRUE if the model is mutable (ie: "items-changed" may be
- * emitted).
- **/
+ * emitted).
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_model_is_mutable (GMenuModel *model)
{
@@ -476,7 +478,9 @@ g_menu_model_is_mutable (GMenuModel *model)
* Query the number of items in @model.
*
* Returns: the number of items
- **/
+ *
+ * Since: 2.32
+ */
gint
g_menu_model_get_n_items (GMenuModel *model)
{
@@ -495,6 +499,8 @@ g_menu_model_get_n_items (GMenuModel *model)
* You must free the iterator with g_object_unref() when you are done.
*
* Returns: (transfer full): a new #GMenuAttributeIter
+ *
+ * Since: 2.32
*/
GMenuAttributeIter *
g_menu_model_iterate_item_attributes (GMenuModel *model,
@@ -525,7 +531,9 @@ g_menu_model_iterate_item_attributes (GMenuModel *model,
* then %NULL is returned.
*
* Returns: (transfer full): the value of the attribute
- **/
+ *
+ * Since: 2.32
+ */
GVariant *
g_menu_model_get_item_attribute_value (GMenuModel *model,
gint item_index,
@@ -556,8 +564,10 @@ g_menu_model_get_item_attribute_value (GMenuModel *model,
* returned.
*
* Returns: %TRUE if the named attribute was found with the expected
- * type
- **/
+ * type
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_model_get_item_attribute (GMenuModel *model,
gint item_index,
@@ -594,7 +604,9 @@ g_menu_model_get_item_attribute (GMenuModel *model,
* You must free the iterator with g_object_unref() when you are done.
*
* Returns: (transfer full): a new #GMenuLinkIter
- **/
+ *
+ * Since: 2.32
+ */
GMenuLinkIter *
g_menu_model_iterate_item_links (GMenuModel *model,
gint item_index)
@@ -616,7 +628,9 @@ g_menu_model_iterate_item_links (GMenuModel *model,
* does not exist, %NULL is returned.
*
* Returns: (transfer full): the linked #GMenuModel, or %NULL
- **/
+ *
+ * Since: 2.32
+ */
GMenuModel *
g_menu_model_get_item_link (GMenuModel *model,
gint item_index,
@@ -648,7 +662,9 @@ g_menu_model_get_item_link (GMenuModel *model,
* entry and not in response to calls -- particularly those from the
* #GMenuModel API. Said another way: the menu must not change while
* user code is running without returning to the mainloop.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_model_items_changed (GMenuModel *model,
gint position,
@@ -690,8 +706,10 @@ struct _GMenuAttributeIterPrivate
* be unreffed using g_variant_unref() when it is no longer in use.
*
* Returns: %TRUE on success, or %FALSE if there is no additional
- * attribute
- **/
+ * attribute
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_attribute_iter_get_next (GMenuAttributeIter *iter,
const gchar **out_name,
@@ -736,7 +754,9 @@ g_menu_attribute_iter_get_next (GMenuAttributeIter *iter,
* attribute exists at all).
*
* Returns: %TRUE on success, or %FALSE when there are no more attributes
- **/
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_attribute_iter_next (GMenuAttributeIter *iter)
{
@@ -753,7 +773,9 @@ g_menu_attribute_iter_next (GMenuAttributeIter *iter)
* The iterator is not advanced.
*
* Returns: the name of the attribute
- **/
+ *
+ * Since: 2.32
+ */
const gchar *
g_menu_attribute_iter_get_name (GMenuAttributeIter *iter)
{
@@ -771,7 +793,9 @@ g_menu_attribute_iter_get_name (GMenuAttributeIter *iter)
* The iterator is not advanced.
*
* Returns: (transfer full): the value of the current attribute
- **/
+ *
+ * Since: 2.32
+ */
GVariant *
g_menu_attribute_iter_get_value (GMenuAttributeIter *iter)
{
@@ -839,7 +863,9 @@ struct _GMenuLinkIterPrivate
* be unreffed using g_object_unref() when it is no longer in use.
*
* Returns: %TRUE on success, or %FALSE if there is no additional link
- **/
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_link_iter_get_next (GMenuLinkIter *iter,
const gchar **out_link,
@@ -885,7 +911,9 @@ g_menu_link_iter_get_next (GMenuLinkIter *iter,
* at all).
*
* Returns: %TRUE on success, or %FALSE when there are no more links
- **/
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_link_iter_next (GMenuLinkIter *iter)
{
@@ -901,7 +929,9 @@ g_menu_link_iter_next (GMenuLinkIter *iter)
* The iterator is not advanced.
*
* Returns: the type of the link
- **/
+ *
+ * Since: 2.32
+ */
const gchar *
g_menu_link_iter_get_name (GMenuLinkIter *iter)
{
@@ -919,7 +949,9 @@ g_menu_link_iter_get_name (GMenuLinkIter *iter)
* The iterator is not advanced.
*
* Returns: (transfer full): the #GMenuModel that is linked to
- **/
+ *
+ * Since: 2.32
+ */
GMenuModel *
g_menu_link_iter_get_value (GMenuLinkIter *iter)
{
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
