summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGMT 2000 Tony Gale <gale@gtk.org>2000-11-21 14:19:15 +0000
committerTony Gale <gale@src.gnome.org>2000-11-21 14:19:15 +0000
commitac22e4f8b4f71d3e7d9775fc26fcb9013f339209 (patch)
treec79c109104257b7d648b6cb24c96a90219e03eb0 /docs
parent7a2e1974f0e509620bd329aa5f0b00ab388280b4 (diff)
downloadgtk+-ac22e4f8b4f71d3e7d9775fc26fcb9013f339209.tar.gz
minor corrections
Tue Nov 21 14:17:51 GMT 2000 Tony Gale <gale@gtk.org> * docs/tutorial/gtk-tut.sgml: minor corrections
Diffstat (limited to 'docs')
-rwxr-xr-xdocs/tutorial/gtk-tut.sgml40
1 files changed, 21 insertions, 19 deletions
diff --git a/docs/tutorial/gtk-tut.sgml b/docs/tutorial/gtk-tut.sgml
index 20373f36e9..5a95946ebb 100755
--- a/docs/tutorial/gtk-tut.sgml
+++ b/docs/tutorial/gtk-tut.sgml
@@ -2,21 +2,21 @@
<book id="gtk-tut">
<bookinfo>
- <date>July 21st 2000</date>
+ <date>November 21st 2000</date>
<title>GTK+ 1.2 Tutorial</title>
<authorgroup>
<author>
- <firstname>Tony</firstname>
- <surname>Gale</surname>
+ <firstname>Tony</firstname>
+ <surname>Gale</surname>
</author>
<author>
- <firstname>Ian</firstname>
- <surname>Main</surname>
+ <firstname>Ian</firstname>
+ <surname>Main</surname>
</author>
</authorgroup>
<abstract>
<para> This is a tutorial on how to use GTK (the GIMP Toolkit) through its C
- interface.</para>
+ interface.</para>
</abstract>
</bookinfo>
@@ -554,14 +554,14 @@ also be attached to these events. These events are:</para>
</listitem>
</itemizedlist>
-<para>In order to connect a callback function to one of these events, you
+<para>In order to connect a callback function to one of these events you
use the function gtk_signal_connect, as described above, using one of
the above event names as the <literal>name</literal> parameter. The callback
function for events has a slightly different form than that for
signals:</para>
<programlisting role="C">
-void callback_func( GtkWidget *widget,
+gint callback_func( GtkWidget *widget,
GdkEvent *event,
gpointer callback_data );
</programlisting>
@@ -569,7 +569,7 @@ void callback_func( GtkWidget *widget,
<para>GdkEvent is a C <literal>union</literal> structure whose type will depend upon which
of the above events has occurred. In order for us to tell which event
has been issued each of the possible alternatives has a <literal>type</literal>
-parameter which reflects the event being issued. The other components
+member that reflects the event being issued. The other components
of the event structure will depend upon the type of the
event. Possible values for the type are:</para>
@@ -1084,7 +1084,7 @@ This is where packing comes in.</para>
<sect1 id="sec-TheoryOfPackingBoxes">
<title>Theory of Packing Boxes</title>
-<para>Most packing is done by creating boxes as in the example above. These
+<para>Most packing is done by creating boxes. These
are invisible widget containers that we can pack our widgets into
which come in two forms, a horizontal box, and a vertical box. When
packing widgets into a horizontal box, the objects are inserted
@@ -2290,7 +2290,7 @@ GtkWidget *gtk_radio_button_new_with_label( GSList *group,
<para>You'll notice the extra argument to these calls. They require a group
to perform their duty properly. The first call to
-gtk_radio_button_new_with_label or gtk_radio_button_new_with_label
+gtk_radio_button_new or gtk_radio_button_new_with_label
should pass NULL as the first argument. Then create a group using:</para>
<programlisting role="C">
@@ -2823,17 +2823,17 @@ Adjustment. The update policies, defined in
are:</para>
<itemizedlist>
-<listitem><simpara>GTK_UPDATE_POLICY_CONTINUOUS - This is the default. The
+<listitem><simpara>GTK_UPDATE_CONTINUOUS - This is the default. The
"value_changed" signal is emitted continuously, i.e., whenever the
slider is moved by even the tiniest amount.</simpara>
</listitem>
-<listitem><simpara>GTK_UPDATE_POLICY_DISCONTINUOUS - The "value_changed" signal is
+<listitem><simpara>GTK_UPDATE_DISCONTINUOUS - The "value_changed" signal is
only emitted once the slider has stopped moving and the user has
released the mouse button.</simpara>
</listitem>
-<listitem><simpara>GTK_UPDATE_POLICY_DELAYED - The "value_changed" signal is emitted
+<listitem><simpara>GTK_UPDATE_DELAYED - The "value_changed" signal is emitted
when the user releases the mouse button, or if the slider stops moving
for a short period of time.</simpara>
</listitem>
@@ -5686,6 +5686,8 @@ pointer to the GList.</para>
glist = g_list_append(glist, "String 4");
gtk_combo_set_popdown_strings( GTK_COMBO(combo), glist) ;
+
+ /* can free glist now, combo takes a copy */
</programlisting>
<para>The combo widget makes a copy of the strings passed to it in the glist
@@ -9225,7 +9227,7 @@ void select_row_callback(GtkWidget *widget,
<programlisting role="C">
gtk_signal_connect(GTK_OBJECT( clist),
- "select_row"
+ "select_row",
GTK_SIGNAL_FUNC(select_row_callback),
NULL);
</programlisting>
@@ -10615,15 +10617,15 @@ standard <literal>File</literal> menu, with the options <literal>Open</literal>,
gtk_menu_append (GTK_MENU (file_menu), quit_item);
/* Attach the callback functions to the activate signal */
- gtk_signal_connect_object (GTK_OBJECT (open_items), "activate",
+ gtk_signal_connect_object (GTK_OBJECT (open_item), "activate",
GTK_SIGNAL_FUNC (menuitem_response),
(gpointer) "file.open");
- gtk_signal_connect_object (GTK_OBJECT (save_items), "activate",
+ gtk_signal_connect_object (GTK_OBJECT (save_item), "activate",
GTK_SIGNAL_FUNC (menuitem_response),
(gpointer) "file.save");
/* We can attach the Quit menu item to our exit function */
- gtk_signal_connect_object (GTK_OBJECT (quit_items), "activate",
+ gtk_signal_connect_object (GTK_OBJECT (quit_item), "activate",
GTK_SIGNAL_FUNC (destroy),
(gpointer) "file.quit");
@@ -15510,7 +15512,7 @@ such as:</para>
</itemizedlist>
<para>For information about the XInput extension, see the <ulink
-url="http://www.msc.cornell.edu/~otaylor/xinput/XInput-HOWTO.html">XInput-HOWTO</ulink>.</para>
+url="http://www.gtk.org/~otaylor/xinput/howto/index.html">XInput HOWTO</ulink>.</para>
<para>If we examine the full definition of, for example, the GdkEventMotion
structure, we see that it has fields to support extended device