Add deprecation notes.

Tue May 11 00:29:53 2004  Matthias Clasen  <maclas@gmx.de>

	* gtk/tmpl/gtkpixmap.sgml:
	* gtk/tmpl/gtkoldeditable.sgml:
	* gtk/tmpl/gtklistitem.sgml:
	* gtk/tmpl/gtklist.sgml:
	* gtk/tmpl/gtkitemfactory.sgml:
	* gtk/tmpl/gtkctree.sgml:
	* gtk/tmpl/gtkclist.sgml: Add deprecation notes.

13 files changed, 156 insertions, 5 deletions

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 8c11fa195f..716f8114ce 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,13 @@
+Tue May 11 00:29:53 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/tmpl/gtkpixmap.sgml: 
+	* gtk/tmpl/gtkoldeditable.sgml: 
+	* gtk/tmpl/gtklistitem.sgml: 
+	* gtk/tmpl/gtklist.sgml: 
+	* gtk/tmpl/gtkitemfactory.sgml: 
+	* gtk/tmpl/gtkctree.sgml: 
+	* gtk/tmpl/gtkclist.sgml: Add deprecation notes.
+
 2004-05-10  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/gtk-sections.txt: Add gtk_menu_get_for_attach_widet,
diff --git a/docs/reference/gtk/tmpl/gtkactiongroup.sgml b/docs/reference/gtk/tmpl/gtkactiongroup.sgml
index 6ec1b5fea0..e364a932e3 100644
--- a/docs/reference/gtk/tmpl/gtkactiongroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkactiongroup.sgml
@@ -332,3 +332,13 @@ gtk_action_group_add_radio_actions() to construct groups of radio actions.
 @domain: 
 
 
+<!-- ##### FUNCTION gtk_action_group_translate_string ##### -->
+<para>
+
+</para>
+
+@action_group: 
+@string: 
+@Returns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkclist.sgml b/docs/reference/gtk/tmpl/gtkclist.sgml
index 482b179b18..ba5316db87 100644
--- a/docs/reference/gtk/tmpl/gtkclist.sgml
+++ b/docs/reference/gtk/tmpl/gtkclist.sgml
@@ -6,8 +6,13 @@ A multi-columned scrolling list widget.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The #GtkCList widget is a very useful multi-columned scrolling list.  It can display
-data in nicely aligned vertical columns, with titles at the top of the list.
+The #GtkCList widget is a very useful multi-columned scrolling list.  
+It can display data in nicely aligned vertical columns, with titles 
+at the top of the list.
+</para>
+<para>
+GtkCList has been deprecated since GTK+ 2.0 and should not be used
+in newly written code. Use #GtkTreeView instead.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkcombobox.sgml b/docs/reference/gtk/tmpl/gtkcombobox.sgml
index 786da0394d..faa53d5882 100644
--- a/docs/reference/gtk/tmpl/gtkcombobox.sgml
+++ b/docs/reference/gtk/tmpl/gtkcombobox.sgml
@@ -32,6 +32,11 @@ a widget used to choose from a list of items.
 
 </para>
 
+<!-- ##### ARG GtkComboBox:add-tearoffs ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkComboBox:column-span-column ##### -->
 <para>
 
@@ -76,6 +81,15 @@ a widget used to choose from a list of items.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_get_wrap_width ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_set_wrap_width ##### -->
 <para>
 
@@ -85,6 +99,15 @@ a widget used to choose from a list of items.
 @width: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_get_row_span_column ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_set_row_span_column ##### -->
 <para>
 
@@ -94,6 +117,15 @@ a widget used to choose from a list of items.
 @row_span: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_get_column_span_column ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_set_column_span_column ##### -->
 <para>
 
@@ -203,6 +235,15 @@ a widget used to choose from a list of items.
 @position: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_get_active_text ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_popup ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkctree.sgml b/docs/reference/gtk/tmpl/gtkctree.sgml
index 204d2c64ae..ad3ec4f749 100644
--- a/docs/reference/gtk/tmpl/gtkctree.sgml
+++ b/docs/reference/gtk/tmpl/gtkctree.sgml
@@ -23,6 +23,10 @@ is %NULL, the position is at the root of the tree and if the sibling
 is %NULL, it will be the last child of parent, otherwise it will be
 inserted just before the sibling.
 </para>
+<para>
+GtkCTree has been deprecated since GTK+ 2.0 and should not be used
+in newly written code. Use #GtkTreeView instead.
+</para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkitemfactory.sgml b/docs/reference/gtk/tmpl/gtkitemfactory.sgml
index 92d23815e6..39a44ad4b1 100644
--- a/docs/reference/gtk/tmpl/gtkitemfactory.sgml
+++ b/docs/reference/gtk/tmpl/gtkitemfactory.sgml
@@ -6,7 +6,7 @@ A factory for menus
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-#GtkItemFactory has been deprecated in favour of #GtkUIManager.
+As of GTK+ 2.4, #GtkItemFactory has been deprecated in favour of #GtkUIManager.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtklist.sgml b/docs/reference/gtk/tmpl/gtklist.sgml
index 37c9cbb4ed..c6f3127c70 100644
--- a/docs/reference/gtk/tmpl/gtklist.sgml
+++ b/docs/reference/gtk/tmpl/gtklist.sgml
@@ -12,6 +12,10 @@ vertically in order, and can be selected.
 The list has many selection modes, which are programmer selective and
 depend on how many elements are able to be selected at the same time.
 </para>
+<para>
+GtkList has been deprecated since GTK+ 2.0 and should not be used
+in newly written code. Use #GtkTreeView instead.
+</para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtklistitem.sgml b/docs/reference/gtk/tmpl/gtklistitem.sgml
index 0682386b1e..cf19feb412 100644
--- a/docs/reference/gtk/tmpl/gtklistitem.sgml
+++ b/docs/reference/gtk/tmpl/gtklistitem.sgml
@@ -7,7 +7,10 @@ an item in a #GtkList.
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 The #GtkListItem widget is used for each item in a #GtkList.
-
+</para>
+<para>
+GtkList has has been deprecated since GTK+ 2.0 and should not be used
+in newly written code. Use #GtkTreeView instead.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkmenu.sgml b/docs/reference/gtk/tmpl/gtkmenu.sgml
index 553ebd5e5c..d1f5884ccd 100644
--- a/docs/reference/gtk/tmpl/gtkmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenu.sgml
@@ -91,6 +91,11 @@ should be accessed using the functions below.
 @menu: the object which received the signal.
 @arg1: 
 
+<!-- ##### ARG GtkMenu:tearoff-state ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkMenu:tearoff-title ##### -->
 <para>
 
@@ -361,6 +366,15 @@ Returns the #GtkWidget that the menu is attached to.
 @Returns: the #GtkWidget that the menu is attached to.
 
 
+<!-- ##### FUNCTION gtk_menu_get_for_attach_widget ##### -->
+<para>
+
+</para>
+
+@widget: 
+@Returns: 
+
+
 <!-- ##### USER_FUNCTION GtkMenuPositionFunc ##### -->
 <para>
 A user function supplied when calling gtk_menu_popup() which controls the
diff --git a/docs/reference/gtk/tmpl/gtkoldeditable.sgml b/docs/reference/gtk/tmpl/gtkoldeditable.sgml
index af5afafb3c..9fd8233798 100644
--- a/docs/reference/gtk/tmpl/gtkoldeditable.sgml
+++ b/docs/reference/gtk/tmpl/gtkoldeditable.sgml
@@ -6,7 +6,8 @@ Base class for text-editing widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+GtkOldEditable has been deprecated since GTK+ 2.0 and should not be used
+in newly written code. Use the #GtkEditable interface instead.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkpixmap.sgml b/docs/reference/gtk/tmpl/gtkpixmap.sgml
index 1b0a071878..a40a9159a5 100644
--- a/docs/reference/gtk/tmpl/gtkpixmap.sgml
+++ b/docs/reference/gtk/tmpl/gtkpixmap.sgml
@@ -17,6 +17,10 @@ X server and so is not available to the client application.
 If you want to create graphical images which can be manipulated by the
 application, look at #GtkImage and #GdkRGB.
 </para>
+<para>
+GtkPixmap has been deprecated since GTK+ 2.0 and should not be used
+in newly written code. Use #GtkImage instead.
+</para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index 9162d5735d..f6ac199a17 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -191,6 +191,11 @@ linkend="GtkTreeModel">GtkTreeModel</link> interface.
 
 </para>
 
+<!-- ##### ARG GtkTreeView:hover-selection ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkTreeView:model ##### -->
 <para>
 
@@ -951,6 +956,42 @@ has some similarity to strcmp() returning 0 for equal strings.
 @search_data: 
 
 
+<!-- ##### FUNCTION gtk_tree_view_get_fixed_height_mode ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_view_set_fixed_height_mode ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@hover: 
+
+
+<!-- ##### FUNCTION gtk_tree_view_get_hover_selection ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_view_set_hover_selection ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@hover: 
+
+
 <!-- ##### USER_FUNCTION GtkTreeDestroyCountFunc ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml
index 9c7adfc0b6..d9c80a0f3a 100644
--- a/docs/reference/gtk/tmpl/gtkwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindow.sgml
@@ -101,6 +101,11 @@ Toplevel which can contain other widgets
 
 </para>
 
+<!-- ##### ARG GtkWindow:focus-on-map ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkWindow:gravity ##### -->
 <para>
 
@@ -924,6 +929,15 @@ Deprecated alias for gtk_window_set_position().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_window_get_focus_on_map ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_window_move ##### -->
 <para>