GNOME.org
 

[gtk+/gtk-2-90: 90/146] Remove remaining GtkWindow deprecated documentation

commit dbfc5fc246243de4c50ab4861924ed5db7d689d9
Author: Javier Jardón <javierjc1982 gmail com>
Date:   Sat Oct 10 20:27:57 2009 +0200

    Remove remaining GtkWindow deprecated documentation
    
    This completes commit 89e3ec8c3d766c333f6e67764ebd7633d61e21cd

 docs/reference/gtk/tmpl/gtkwindow.sgml |   88 --------------------------------
 docs/tutorial/gtk-tut.sgml             |    2 +-
 docs/tutorial/gtk_tut.sgml             |    9 ++--
 docs/tutorial/gtk_tut_12.es.sgml       |    5 +-
 docs/tutorial/gtk_tut_it.sgml          |    2 +-
 examples/colorsel/colorsel.c           |    2 +-
 examples/text/text.c                   |    1 -
 modules/other/gail/tests/ferret.c      |    1 -
 8 files changed, 9 insertions(+), 101 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml
index 0ad26a5..8e7efa1 100644
--- a/docs/reference/gtk/tmpl/gtkwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindow.sgml
@@ -252,86 +252,6 @@ window (synonymous with gtk_window_add_accel_group().
 @wmclass_class: 
 
 
-<!-- ##### FUNCTION gtk_window_set_policy ##### -->
-<para>
-Changes how a toplevel window deals with its size request and user resize
-attempts. There are really only two reasonable ways to call this function:
-<orderedlist>
-<listitem>
-<para>
-<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, TRUE, FALSE)</literal> 
-means that the window is user-resizable.
-</para>
-</listitem>
-<listitem>
-<para>
-<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, FALSE, TRUE)</literal> 
-means that the window's size is program-controlled, and should simply match 
-the current size request of the window's children.
-</para>
-</listitem>
-</orderedlist>
-The first policy is the default, that is, by default windows are designed to 
-be resized by users.
-</para>
-
-<para>
-The basic ugly truth of this function is that it should be simply:
-<literal>
- void gtk_window_set_resizable (GtkWindow* window, gboolean setting);
-</literal>
-...which is why GTK+ 2.0 introduces gtk_window_set_resizable(), which you 
-should use instead of gtk_window_set_policy().
-</para>
-
-<para>
-If set to %TRUE, the @allow_grow parameter allows the user to expand the window
-beyond the size request of its child widgets. If @allow_grow is %TRUE, be sure to
-check that your child widgets work properly as the window is resized.
-</para>
-
-<para>
-A toplevel window will always change size to ensure its child widgets receive
-their requested size. This means that if you add child widgets, the toplevel
-window will expand to contain them. However, normally the toplevel will not
-shrink to fit the size request of its children if it's too large; the
- auto_shrink parameter causes the window to shrink when child widgets have too
-much space. @auto_shrink is normally used with the second of the two window
-policies mentioned above.  That is, set @auto_shrink to %TRUE if you want the
-window to have a fixed, always-optimal size determined by your program.
-</para>
-
-<para>
-Note that @auto_shrink doesn't do anything if @allow_shrink and @allow_grow are
-both set to %FALSE.
-</para>
-
-<para>
-Neither of the two suggested window policies set the @allow_shrink parameter to
-%TRUE.  If @allow_shrink is %TRUE, the user can shrink the window so that its
-children do not receive their full size request; this is basically a bad thing,
-because most widgets will look wrong if this happens. Furthermore GTK+ has a
-tendency to re-expand the window if size is recalculated for any reason. The
-upshot is that @allow_shrink should always be set to %FALSE.
-</para>
-
-<para>
-Sometimes when you think you want to use @allow_shrink, the real problem is that
-some specific child widget is requesting too much space, so the user can't
-shrink the window sufficiently. Perhaps you are calling gtk_widget_set_size_request()
-on a child widget, and forcing its size request to be too large. Instead of
-setting the child's usize, consider using gtk_window_set_default_size() so that
-the child gets a larger allocation than it requests.
-</para>
-
- window: the window
- allow_shrink: whether the user can shrink the window below its size request
- allow_grow: whether the user can grow the window larger than its size request
- auto_shrink: whether the window automatically snaps back to its size request 
-              if it's larger
- Deprecated: Use gtk_window_set_resizable() instead.
-
-
 <!-- ##### FUNCTION gtk_window_set_resizable ##### -->
 <para>
 
@@ -368,14 +288,6 @@ the child gets a larger allocation than it requests.
 @accel_group: 
 
 
-<!-- ##### MACRO gtk_window_position ##### -->
-<para>
-Deprecated alias for gtk_window_set_position().
-</para>
-
- Deprecated: Use gtk_window_set_position() instead.
-
-
 <!-- ##### FUNCTION gtk_window_activate_focus ##### -->
 <para>
 
diff --git a/docs/tutorial/gtk-tut.sgml b/docs/tutorial/gtk-tut.sgml
index 7897644..bf97305 100755
--- a/docs/tutorial/gtk-tut.sgml
+++ b/docs/tutorial/gtk-tut.sgml
@@ -6134,7 +6134,7 @@ gint main( gint   argc,
 
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable ((GTK_WINDOW (window), TRUE);
 
   /* Attach to the "delete" and "destroy" events so we can exit */
 
diff --git a/docs/tutorial/gtk_tut.sgml b/docs/tutorial/gtk_tut.sgml
index bdf99db..cd95b14 100644
--- a/docs/tutorial/gtk_tut.sgml
+++ b/docs/tutorial/gtk_tut.sgml
@@ -3811,7 +3811,7 @@ int main( int   argc,
     pdata = g_malloc( sizeof(ProgressData) );
   
     pdata->window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
-    gtk_window_set_policy (GTK_WINDOW (pdata->window), FALSE, FALSE, TRUE);
+    gtk_window_set_resizable (GTK_WINDOW (pdata->window), FALSE);
 
     gtk_signal_connect (GTK_OBJECT (pdata->window), "destroy",
 	                GTK_SIGNAL_FUNC (destroy_progress),
@@ -5943,7 +5943,7 @@ void calendar_select_font( GtkWidget    *button,
     g_return_if_fail(GTK_IS_FONT_SELECTION_DIALOG(window));
     calendar->font_dialog = window;
     
-    gtk_window_position (GTK_WINDOW (window), GTK_WIN_POS_MOUSE);
+    gtk_window_set_position (GTK_WINDOW (window), GTK_WIN_POS_MOUSE);
     
     gtk_signal_connect (GTK_OBJECT (window), "destroy",
 			GTK_SIGNAL_FUNC (gtk_widget_destroyed),
@@ -6011,7 +6011,7 @@ void create_calendar()
 		     GTK_SIGNAL_FUNC(gtk_false),
 		     NULL);
 
-  gtk_window_set_policy(GTK_WINDOW(window), FALSE, FALSE, TRUE);
+  gtk_window_set_resizable (GTK_WINDOW(window), FALSE);
 
   vbox = gtk_vbox_new(FALSE, DEF_PAD);
   gtk_container_add (GTK_CONTAINER (window), vbox);
@@ -6370,7 +6370,7 @@ gint main( gint   argc,
 
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW(window), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW(window), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable ((GTK_WINDOW(window), TRUE);
 
   /* Attach to the "delete" and "destroy" events so we can exit */
 
@@ -10691,7 +10691,6 @@ int main( int argc,
  
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_widget_set_usize (window, 600, 500);
-  gtk_window_set_policy (GTK_WINDOW(window), TRUE, TRUE, FALSE);  
   gtk_signal_connect (GTK_OBJECT (window), "destroy",
 		      GTK_SIGNAL_FUNC(close_application),
 		      NULL);
diff --git a/docs/tutorial/gtk_tut_12.es.sgml b/docs/tutorial/gtk_tut_12.es.sgml
index 631a270..bba663b 100755
--- a/docs/tutorial/gtk_tut_12.es.sgml
+++ b/docs/tutorial/gtk_tut_12.es.sgml
@@ -3749,7 +3749,7 @@ int main( int   argc,
     pdata = g_malloc( sizeof(ProgressData) );
   
     pdata->ventana = gtk_window_new (GTK_WINDOW_TOPLEVEL);
-    gtk_window_set_policy (GTK_WINDOW (pdata->ventana), FALSE, FALSE, TRUE);
+    gtk_window_set_resizable (GTK_WINDOW (pdata->ventana), FALSE);
 
     gtk_signal_connect (GTK_OBJECT (pdata->ventana), "destroy",
 	                GTK_SIGNAL_FUNC (destroy_progress),
@@ -5727,7 +5727,7 @@ gint main (gint argc, gchar *argv[])
 
   ventana = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW(ventana), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW(ventana), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable (GTK_WINDOW(ventana), TRUE);
 
   /* Enlaza con los eventos «delete» y «destroy», para que podamos
      salir */
@@ -10161,7 +10161,6 @@ int main (int argc, char *argv[])
  
   ventana = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_widget_set_usize (ventana, 600, 500);
-  gtk_window_set_policy (GTK_WINDOW(ventana), TRUE, TRUE, FALSE);  
   gtk_signal_connect (GTK_OBJECT (ventana), "destroy",
 		      GTK_SIGNAL_FUNC(close_application),
 		      NULL);
diff --git a/docs/tutorial/gtk_tut_it.sgml b/docs/tutorial/gtk_tut_it.sgml
index 994185d..3d3c43e 100644
--- a/docs/tutorial/gtk_tut_it.sgml
+++ b/docs/tutorial/gtk_tut_it.sgml
@@ -3456,7 +3456,7 @@ gint main (gint argc, gchar *argv[])
 
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW(window), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW(window), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable (GTK_WINDOW(window), TRUE);
 
   /* colleghiamo gli eventi "delete" e "destroy" per poter uscire */
 
diff --git a/examples/colorsel/colorsel.c b/examples/colorsel/colorsel.c
index cd2801c..9d3671d 100644
--- a/examples/colorsel/colorsel.c
+++ b/examples/colorsel/colorsel.c
@@ -90,7 +90,7 @@ gint main( gint   argc,
 
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
-  gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);
+  gtk_window_set_resizable (GTK_WINDOW (window), TRUE);
 
   /* Attach to the "delete" and "destroy" events so we can exit */
 
diff --git a/examples/text/text.c b/examples/text/text.c
index c3439cb..97732d0 100644
--- a/examples/text/text.c
+++ b/examples/text/text.c
@@ -47,7 +47,6 @@ int main( int argc,
  
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_widget_set_size_request (window, 600, 500);
-  gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, FALSE);  
   g_signal_connect (G_OBJECT (window), "destroy",
                     G_CALLBACK (close_application),
                     NULL);
diff --git a/modules/other/gail/tests/ferret.c b/modules/other/gail/tests/ferret.c
index 531651b..02d106f 100644
--- a/modules/other/gail/tests/ferret.c
+++ b/modules/other/gail/tests/ferret.c
@@ -1666,7 +1666,6 @@ _create_window (void)
     {
         window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
         gtk_widget_set_name (window, "Ferret Window");
-        gtk_window_set_policy (GTK_WINDOW(window), TRUE, TRUE, FALSE);
 
         g_signal_connect (GTK_OBJECT (window), "destroy",
                            G_CALLBACK (gtk_widget_destroyed),
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]