Add versioned deprecation information

This commit is contained in:
Matthias Clasen
2005-12-05 15:38:54 +00:00
parent a127920458
commit 0b5560da8b
17 changed files with 80 additions and 47 deletions

View File

@@ -1,3 +1,13 @@
2005-12-05 Matthias Clasen <mclasen@redhat.com>
* glib/tmpl/trees-nary.sgml:
* glib/tmpl/linked_lists_single.sgml:
* glib/tmpl/linked_lists_double.sgml:
* glib/tmpl/caches.sgml:
* glib/tmpl/strings.sgml:
* glib/tmpl/scanner.sgml:
* glib/tmpl/main.sgml: Add versioned deprecation.
Mon Dec 5 15:53:37 2005 Tim Janik <timj@imendio.com>
* glib/tmpl/memory_slices.sgml: updates to new g_slice API

View File

@@ -123,8 +123,8 @@ Calls the given function for each of the values in the #GCache.
@cache: a #GCache.
@func: the function to call with each #GCache value.
@user_data: user data to pass to the function.
@Deprecated: Since it passes pointers to internal data structures
to @func; use g_cache_key_foreach() instead
@Deprecated:2.10: The reason is that it passes pointers to internal data
structures to @func; use g_cache_key_foreach() instead
<!-- ##### USER_FUNCTION GCacheDestroyFunc ##### -->

View File

@@ -502,7 +502,7 @@ with <option>--disable-mem-pools</option>
</para>
@allocator: the #GAllocator to use when allocating #GList elements.
@Deprecated: Since 2.10, it does nothing, since #GList has been
@Deprecated:2.10: It does nothing, since #GList has been
converted to the <link linkend="glib-Memory-Slices">slice allocator</link>
@@ -515,8 +515,7 @@ Note that this function is not available if GLib has been compiled
with <option>--disable-mem-pools</option>
</para>
@Deprecated: Since 2.10, it does nothing, since #GList has been
@Deprecated:2.10: It does nothing, since #GList has been
converted to the <link linkend="glib-Memory-Slices">slice allocator</link>

View File

@@ -434,7 +434,7 @@ with <option>--disable-mem-pools</option>
</para>
@dummy: the #GAllocator to use when allocating #GSList elements.
@Deprecated: Since 2.10, it does nothing, since #GSList has been
@Deprecated:2.10: It does nothing, since #GSList has been
converted to the <link linkend="glib-Memory-Slices">slice allocator</link>
@@ -447,8 +447,7 @@ Note that this function is not available if GLib has been compiled
with <option>--disable-mem-pools</option>
</para>
@Deprecated: Since 2.10, it does nothing, since #GSList has been
@Deprecated:2.10: It does nothing, since #GSList has been
converted to the <link linkend="glib-Memory-Slices">slice allocator</link>

View File

@@ -180,7 +180,7 @@ Creates a new #GMainLoop for the default main loop.
@is_running: set to %TRUE to indicate that the loop is running. This is not
very important since calling g_main_run() will set this to %TRUE anyway.
@Returns: a new #GMainLoop.
@Deprecated: Use g_main_loop_new() instead.
@Deprecated:2.2: Use g_main_loop_new() instead.
<!-- ##### MACRO g_main_destroy ##### -->
@@ -189,7 +189,7 @@ Frees the memory allocated for the #GMainLoop.
</para>
@loop: a #GMainLoop.
@Deprecated: Use g_main_loop_unref() instead.
@Deprecated:2.2: Use g_main_loop_unref() instead.
<!-- ##### MACRO g_main_run ##### -->
@@ -198,7 +198,7 @@ Runs a main loop until it stops running.
</para>
@loop: a #GMainLoop.
@Deprecated: Use g_main_loop_run() instead.
@Deprecated:2.2: Use g_main_loop_run() instead.
<!-- ##### MACRO g_main_quit ##### -->
@@ -208,7 +208,7 @@ it will now return.
</para>
@loop: a #GMainLoop.
@Deprecated: Use g_main_loop_quit() instead.
@Deprecated:2.2: Use g_main_loop_quit() instead.
<!-- ##### MACRO g_main_is_running ##### -->
@@ -218,7 +218,7 @@ Checks if the main loop is running.
@loop: a #GMainLoop.
@Returns: %TRUE if the main loop is running.
@Deprecated: USe g_main_loop_is_running() instead.
@Deprecated:2.2: USe g_main_loop_is_running() instead.
<!-- ##### MACRO G_PRIORITY_HIGH ##### -->
@@ -326,7 +326,7 @@ becomes ready. It will return after an event source has been processed.
If set to %FALSE it will return immediately if no event source is ready to be
processed.
@Returns: %TRUE if more events are pending.
@Deprecated: Use g_main_context_iteration() instead.
@Deprecated:2.2: Use g_main_context_iteration() instead.
<!-- ##### FUNCTION g_main_context_pending ##### -->
@@ -345,7 +345,7 @@ Checks if any events are pending for the default #GMainContext
</para>
@Returns: %TRUE if any events are pending.
@Deprecated: Use g_main_context_pending() instead.
@Deprecated:2.2: Use g_main_context_pending() instead.
<!-- ##### FUNCTION g_main_context_find_source_by_id ##### -->
@@ -527,7 +527,7 @@ for the default main context.
</para>
@func: the function to call to poll all file descriptors.
@Deprecated: Use g_main_context_set_poll_func() instead.
@Deprecated:2.2: Use g_main_context_set_poll_func() instead.
<!-- ##### FUNCTION g_timeout_source_new ##### -->

View File

@@ -386,20 +386,18 @@ Removes a symbol from a scope.
<!-- ##### MACRO g_scanner_freeze_symbol_table ##### -->
<para>
This function is deprecated and will be removed in the next major
release of GLib. It does nothing.
</para>
@scanner: a #GScanner.
@Deprecated:2.2: This macro does nothing.
<!-- ##### MACRO g_scanner_thaw_symbol_table ##### -->
<para>
This function is deprecated and will be removed in the next major
release of GLib. It does nothing.
</para>
@scanner: a #GScanner.
@Deprecated:2.2: This macro does nothing.
<!-- ##### FUNCTION g_scanner_lookup_symbol ##### -->
@@ -564,7 +562,7 @@ Adds a symbol to the default scope.
@scanner: a #GScanner.
@symbol: the symbol to add.
@value: the value of the symbol.
@Deprecated: Use g_scanner_scope_add_symbol() instead.
@Deprecated:2.2: Use g_scanner_scope_add_symbol() instead.
<!-- ##### MACRO g_scanner_remove_symbol ##### -->
@@ -574,7 +572,7 @@ Removes a symbol from the default scope.
@scanner: a #GScanner.
@symbol: the symbol to remove.
@Deprecated: Use g_scanner_scope_remove_symbol() instead.
@Deprecated:2.2: Use g_scanner_scope_remove_symbol() instead.
<!-- ##### MACRO g_scanner_foreach_symbol ##### -->
@@ -585,6 +583,6 @@ Calls a function for each symbol in the default scope.
@scanner: a #GScanner.
@func: the function to call with each symbol.
@data: data to pass to the function.
@Deprecated: Use g_scanner_scope_foreach_symbol() instead.
@Deprecated:2.2: Use g_scanner_scope_foreach_symbol() instead.

View File

@@ -528,8 +528,8 @@ with <option>--disable-mem-pools</option>
</para>
@dummy: the #GAllocator to use when allocating #GNode elements.
@Deprecated: Since 2.10, it does nothing, since #GNode has been
converted to the <link linkend="glib-Memory-Slices">slice allocator</link>
@Deprecated:2.10: It does nothing, since #GNode has been converted
to the <link linkend="glib-Memory-Slices">slice allocator</link>
<!-- ##### FUNCTION g_node_pop_allocator ##### -->
@@ -541,7 +541,7 @@ Note that this function is not available if GLib has been compiled
with <option>--disable-mem-pools</option>
</para>
@Deprecated: Since 2.10, it does nothing, since #GNode has been
converted to the <link linkend="glib-Memory-Slices">slice allocator</link>
@Deprecated:2.10: It does nothing, since #GNode has been converted
to the <link linkend="glib-Memory-Slices">slice allocator</link>

View File

@@ -1129,7 +1129,7 @@ This is an internal function introduced mainly for C marshallers.
@value: a valid #GValue of type %G_TYPE_STRING
@v_string: duplicated unowned string to be set
@Deprecated: Use g_value_take_string() instead.
@Deprecated:2.4: Use g_value_take_string() instead.
<!-- ##### FUNCTION g_value_get_string ##### -->
@@ -1236,7 +1236,7 @@ This is an internal function introduced mainly for C marshallers.
@value: a valid #GValue of type %G_TYPE_PARAM
@param: the #GParamSpec to be set
@Deprecated: Use g_value_take_param() instead.
@Deprecated:2.4: Use g_value_take_param() instead.
<!-- ##### FUNCTION g_value_get_param ##### -->
@@ -1351,7 +1351,7 @@ This is an internal function introduced mainly for C marshallers.
@value: a valid #GValue of %G_TYPE_BOXED derived type
@v_boxed: duplicated unowned boxed value to be set
@Deprecated: Use g_value_take_boxed() instead.
@Deprecated:2.4: Use g_value_take_boxed() instead.
<!-- ##### FUNCTION g_value_get_boxed ##### -->
@@ -1528,7 +1528,7 @@ This is an internal function introduced mainly for C marshallers.
@value: a valid #GValue of %G_TYPE_OBJECT derived type
@v_object: object value to be set
@Deprecated: Use g_value_take_object() instead.
@Deprecated:2.4: Use g_value_take_object() instead.
<!-- ##### FUNCTION g_value_get_object ##### -->