+2000-10-27 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
+
+ * glib/glib-sections.txt, glib/tmpl/hash_tables.sgml,
+ glib/tmpl/macros_misc.sgml, glib/tmpl/misc_utils.sgml,
+ glib/tmpl/scanner.sgml: Document the recently deprecated functions
+ as such.
+
2000-10-15 Raja R Harinath <harinath@cs.umn.edu>
'make distcheck' fixes.
<!-- ##### FUNCTION g_hash_table_freeze ##### -->
<para>
-Disable resizing of a #GHashTable.
-</para>
-<para>
-This should be used if you need to make a lot of changes to a #GHashTable
-at once, as it reduces the number of times that the #GHashTable is rebuilt.
-You should call g_hash_table_thaw() after updating the #GHashTable to
-enable resizing again.
+This function is deprecated and will be removed in the next major
+release of GLib. It does nothing.
</para>
-@hash_table: a #GHashTable.
+@hash_table:
<!-- ##### FUNCTION g_hash_table_thaw ##### -->
<para>
-Enables resizing of a #GHashTable.
+This function is deprecated and will be removed in the next major
+release of GLib. It does nothing.
</para>
-@hash_table: a #GHashTable.
+@hash_table:
<!-- ##### FUNCTION g_hash_table_destroy ##### -->
<!-- ##### FUNCTION g_basename ##### -->
<para>
-Gets the name of the file without any leading directory components.
-It returns a pointer into the given file name string.
+This function is deprecated and will be removed in the next major
+release of GLib. Use g_path_get_basename() instead.
+</para>
+
+<para>
+Gets the name of the file without any leading
+directory components. It returns a pointer into the given file name
+string.
</para>
@file_name: the name of the file.
<!-- ##### FUNCTION g_dirname ##### -->
<para>
+This function is deprecated and will be removed in the next major
+release of GLib. Use g_path_get_dirname() instead.
+</para>
+
+<para>
Gets the directory components of a file name.
If the file name has no directory components "." is returned.
The returned string should be freed when no longer needed.
<!-- ##### FUNCTION g_path_get_dirname ##### -->
<para>
-
+Gets the directory components of a file name. If the file name has no
+directory components "." is returned. The returned string should be
+freed when no longer needed.
</para>
-@file_name:
-@Returns:
+@file_name: the name of the file.
+@Returns: the directory components of the file.
<!-- ##### FUNCTION g_path_get_basename ##### -->
<para>
+Gets the name of the file without any leading directory components.
+The returned string should be freed when no longer needed.
+</para>
+<note>
+<para>
+This function allocates new memory for the returned string. This is
+different from the old g_basename() function, which returned a pointer
+into the argument.
</para>
+</note>
-@file_name:
-@Returns:
+@file_name: the name of the file.
+@Returns: the name of the file without any leading directory components.
<!-- ##### FUNCTION g_filename_to_utf8 ##### -->
<!-- ##### FUNCTION 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:
<!-- ##### FUNCTION 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: