+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkitemfactory.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkstyle.c:
+ * gtk/gtkrc.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkdialog.c:
+ * gtk/gtktreemodel.c: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
2002-04-18 Tor Lillqvist <tml@iki.fi>
* gdk-pixbuf/Makefile.am (uninstall-libtool-import-lib)
+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkitemfactory.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkstyle.c:
+ * gtk/gtkrc.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkdialog.c:
+ * gtk/gtktreemodel.c: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
2002-04-18 Tor Lillqvist <tml@iki.fi>
* gdk-pixbuf/Makefile.am (uninstall-libtool-import-lib)
+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkitemfactory.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkstyle.c:
+ * gtk/gtkrc.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkdialog.c:
+ * gtk/gtktreemodel.c: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
2002-04-18 Tor Lillqvist <tml@iki.fi>
* gdk-pixbuf/Makefile.am (uninstall-libtool-import-lib)
+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkitemfactory.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkstyle.c:
+ * gtk/gtkrc.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkdialog.c:
+ * gtk/gtktreemodel.c: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
2002-04-18 Tor Lillqvist <tml@iki.fi>
* gdk-pixbuf/Makefile.am (uninstall-libtool-import-lib)
+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkitemfactory.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkstyle.c:
+ * gtk/gtkrc.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkdialog.c:
+ * gtk/gtktreemodel.c: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
2002-04-18 Tor Lillqvist <tml@iki.fi>
* gdk-pixbuf/Makefile.am (uninstall-libtool-import-lib)
+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkitemfactory.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkstyle.c:
+ * gtk/gtkrc.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkdialog.c:
+ * gtk/gtktreemodel.c: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
2002-04-18 Tor Lillqvist <tml@iki.fi>
* gdk-pixbuf/Makefile.am (uninstall-libtool-import-lib)
+2002-04-18 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/tmpl/rgb.sgml:
+ * gdk/tmpl/general.sgml:
+ * gtk/tmpl/gtktogglebutton.sgml:
+ * gtk/tmpl/gtkaccellabel.sgml:
+ * gtk/tmpl/gtkradiobutton.sgml:
+ * gtk/tmpl/gtktreemodel.sgml:
+ * gtk/tmpl/gtkwidget.sgml:
+ * gtk/tmpl/gtkimage.sgml:
+ * gtk/tmpl/gtktooltips.sgml:
+ * gtk/tmpl/gtksignal.sgml:
+ * gtk/tmpl/gtkcombo.sgml:
+ * gtk/tmpl/gtkdnd.sgml:
+ * gtk/tmpl/gtksocket.sgml:
+ * gtk/tmpl/gtkdrawingarea.sgml:
+ * gtk/tmpl/gtkobject.sgml:
+ * gtk/tmpl/gtkpaned.sgml:
+ * gtk/tmpl/gtkmain.sgml: s/<!>/<!-- -->/g throughout the
+ documentation to bring the produced Docbook closer to XML.
+
Tue Mar 26 15:41:49 2002 Owen Taylor <otaylor@redhat.com>
* gtk/building.sgml: Add a mention of running ldconfig.
<example>
<title>Trapping an X error.</title>
<programlisting>
- gdk_error_trap_push (<!>);
+ gdk_error_trap_push (<!-- -->);
/* ... Call the X function which may cause an error here ... */
/* Flush the X queue to catch errors now. */
- gdk_flush (<!>);
+ gdk_flush (<!-- -->);
- if (gdk_error_trap_pop (<!>))
+ if (gdk_error_trap_pop (<!-- -->))
{
/* ... Handle the error here ... */
}
gtk_init (&argc, &argv);
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
- darea = gtk_drawing_area_new (<!>);
+ darea = gtk_drawing_area_new (<!-- -->);
gtk_widget_set_size_request (darea, IMAGE_WIDTH, IMAGE_HEIGHT);
gtk_container_add (GTK_CONTAINER (window), darea);
gtk_signal_connect (GTK_OBJECT (darea), "expose-event",
}
}
- gtk_main (<!>);
+ gtk_main (<!-- -->);
return 0;
}
GtkAccelGroup *accel_group;
/* Create a #GtkAccelGroup and add it to the window. */
- accel_group = gtk_accel_group_new (<!>);
+ accel_group = gtk_accel_group_new (<!-- -->);
gtk_window_add_accel_group (GTK_WINDOW (window), accel_group);
/* Create the menu item using the convenience function. */
gtk_container_add (GTK_CONTAINER (menu), save_item);
/* Now add the accelerator to the GtkMenuItem. Note that since we called
- gtk_menu_item_new_with_label(<!>) to create the GtkMenuItem the
+ gtk_menu_item_new_with_label(<!-- -->) to create the GtkMenuItem the
GtkAccelLabel is automatically set up to display the GtkMenuItem
accelerators. We just need to make sure we use GTK_ACCEL_VISIBLE here. */
gtk_widget_add_accelerator (save_item, "activate", accel_group,
items = g_list_append (items, "Fourth Item");
items = g_list_append (items, "Fifth Item");
- combo = gtk_combo_new (<!>);
+ combo = gtk_combo_new (<!-- -->);
gtk_combo_set_popdown_strings (GTK_COMBO (combo), items);
</programlisting>
</example>
<programlisting>
GtkWidget *combo, *item, *hbox, *arrow, *label;
- combo = gtk_combo_new (<!>);
+ combo = gtk_combo_new (<!-- -->);
- item = gtk_list_item_new (<!>);
+ item = gtk_list_item_new (<!-- -->);
gtk_widget_show (item);
/* You can put almost anything into the GtkListItem widget. Here we will use
on behalf of a widget for drops onto that widget. The @targets
and @actions fields only are used if %GTK_DEST_DEFAULT_MOTION
or %GTK_DEST_DEFAULT_DROP are given.
-@targets: a pointer to an array of #GtkTargetEntry<!>s indicating
+@targets: a pointer to an array of #GtkTargetEntry<!-- -->s indicating
the drop types that this widget will accept.
@n_targets: the number of entries in @targets.
@actions: a bitmask of possible actions for a drop onto this
return TRUE;
}
[...]
- GtkWidget *drawing_area = gtk_drawing_area_new (<!>);
+ GtkWidget *drawing_area = gtk_drawing_area_new (<!-- -->);
gtk_widget_set_size_request (drawing_area, 100, 100);
g_signal_connect (G_OBJECT (drawing_area), "expose_event",
G_CALLBACK (expose_event_callback), NULL);
image = gtk_image_new_from_file ("myfile.png");
- event_box = gtk_event_box_new (<!>);
+ event_box = gtk_event_box_new (<!-- -->);
gtk_container_add (GTK_CONTAINER (event_box), image);
main (int argc, char **argv)
{
/* Initialize i18n support */
- gtk_set_locale (<!>);
+ gtk_set_locale (<!-- -->);
/* Initialize the widget set */
gtk_init (&argc, &argv);
gtk_widget_show_all (mainwin);
/* Enter the main event loop, and wait for user interaction */
- gtk_main (<!>);
+ gtk_main (<!-- -->);
/* The user lost interest */
return 0;
<programlisting>
/* computation going on */
...
- while (gtk_events_pending (<!>))
- gtk_main_iteration (<!>);
+ while (gtk_events_pending (<!-- -->))
+ gtk_main_iteration (<!-- -->);
...
/* computation continued */
</programlisting>
gtk_container_add (GTK_CONTAINER (win), but);
gtk_widget_show_all (win);
- gtk_main (<!>);
+ gtk_main (<!-- -->);
return 0;
}
</programlisting>
The purpose of the floating reference is to keep the child widget alive
until you add it to a parent container:
<informalexample><programlisting>
- button = gtk_button_new (<!>);
+ button = gtk_button_new (<!-- -->);
/* button has one floating reference to keep it alive */
gtk_container_add (GTK_CONTAINER (container), button);
/* button has one non-floating reference owned by the container */
<example>
<title>Creating a paned widget with minimum sizes.</title>
<programlisting>
-GtkWidget *hpaned = gtk_hpaned_new (<!>);
+GtkWidget *hpaned = gtk_hpaned_new (<!-- -->);
GtkWidget *frame1 = gtk_frame_new (NULL);
GtkWidget *frame2 = gtk_frame_new (NULL);
gtk_frame_set_shadow_type (GTK_FRAME (frame1), GTK_SHADOW_IN);
/* Create a radio button with a GtkEntry widget */
radio1 = gtk_radio_button_new (NULL);
- entry = gtk_entry_new (<!>);
+ entry = gtk_entry_new (<!-- -->);
gtk_container_add (GTK_CONTAINER (radio1), entry);
<para>
The GTK+ signal system merely proxies the GLib signal system now. For future
usage, direct use of the <link linkend="gobject-Signals">GSignal</link> API is recommended, this avoids significant
-performance hits where #GtkArg structures have to be converted into #GValue<!>s.
+performance hits where #GtkArg structures have to be converted into #GValue<!-- -->s.
</para>
<refsect2>
<example>
<title>Obtaining the window ID of a socket.</title>
<programlisting>
-GtkWidget *socket = gtk_socket_new (<!>);
+GtkWidget *socket = gtk_socket_new (<!-- -->);
gtk_widget_show (socket);
gtk_container_add (GTK_CONTAINER (parent), socket);
void make_toggles (void) {
GtkWidget *dialog, *toggle1, *toggle2;
- dialog = gtk_dialog_new (<!>);
+ dialog = gtk_dialog_new (<!-- -->);
toggle1 = gtk_toggle_button_new_with_label ("Hi, i'm a toggle button.");
/* Makes this toggle button invisible */
GtkWidget *load_button, *save_button, *hbox;
GtkTooltips *button_bar_tips;
- button_bar_tips = gtk_tooltips_new (<!>);
+ button_bar_tips = gtk_tooltips_new (<!-- -->);
/* Create the buttons and pack them into a GtkHBox */
hbox = gtk_hbox_new (TRUE, 2);
gchar *str_data;
gint int_data;
- /* Make sure you terminate calls to gtk_tree_model_get(<!>)
+ /* Make sure you terminate calls to gtk_tree_model_get(<!-- -->)
* with a '-1' value
*/
gtk_tree_model_get (list_store, &iter,
</para>
@GTK_TOPLEVEL:
- widgets without a real parent, as there are #GtkWindow<!>s and
- #GtkMenu<!>s have this flag set throughout their lifetime.
+ widgets without a real parent, as there are #GtkWindow<!-- -->s and
+ #GtkMenu<!-- -->s have this flag set throughout their lifetime.
Toplevel widgets always contain their own #GdkWindow.
@GTK_NO_WINDOW:
Indicative for a widget that does not provide its own #GdkWindow.
*
* Here's a simple example:
* <informalexample><programlisting>
- * <!>GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog",
- * <!> main_app_window,
- * <!> GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
- * <!> GTK_STOCK_OK,
- * <!> GTK_RESPONSE_ACCEPT,
- * <!> GTK_STOCK_CANCEL,
- * <!> GTK_RESPONSE_REJECT,
- * <!> NULL);
+ * GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog",
+ * main_app_window,
+ * GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
+ * GTK_STOCK_OK,
+ * GTK_RESPONSE_ACCEPT,
+ * GTK_STOCK_CANCEL,
+ * GTK_RESPONSE_REJECT,
+ * NULL);
* </programlisting></informalexample>
*
* Return value: a new #GtkDialog
*
* Typical usage of this function might be:
* <informalexample><programlisting>
- * <!> gint result = gtk_dialog_run (GTK_DIALOG (dialog));
- * <!> switch (result)
- * <!> {
- * <!> case GTK_RESPONSE_ACCEPT:
- * <!> do_application_specific_something (<!-- -->);
- * <!> break;
- * <!> default:
- * <!> do_nothing_since_dialog_was_cancelled (<!-- -->);
- * <!> break;
- * <!> }
- * <!> gtk_widget_destroy (dialog);
+ * gint result = gtk_dialog_run (GTK_DIALOG (dialog));
+ * switch (result)
+ * {
+ * case GTK_RESPONSE_ACCEPT:
+ * do_application_specific_something (<!-- -->);
+ * break;
+ * default:
+ * do_nothing_since_dialog_was_cancelled (<!-- -->);
+ * break;
+ * }
+ * gtk_widget_destroy (dialog);
* </programlisting></informalexample>
*
* Return value: response ID
* gtk_icon_factory_new:
*
* Creates a new #GtkIconFactory. An icon factory manages a collection
- * of #GtkIconSet<!>s; a #GtkIconSet manages a set of variants of a
+ * of #GtkIconSet<!-- -->s; a #GtkIconSet manages a set of variants of a
* particular icon (i.e. a #GtkIconSet contains variants for different
* sizes and widget states). Icons in an icon factory are named by a
* stock ID, which is a simple string identifying the icon. Each
- * #GtkStyle has a list of #GtkIconFactory<!>s derived from the current
+ * #GtkStyle has a list of #GtkIconFactory<!-- -->s derived from the current
* theme; those icon factories are consulted first when searching for
* an icon. If the theme doesn't set a particular icon, GTK+ looks for
* the icon in a list of default icon factories, maintained by
* gtk_item_factory_create_items:
* @ifactory: a #GtkItemFactory
* @n_entries: the length of @entries
- * @entries: an array of #GtkItemFactoryEntry<!>s whose @callback members
+ * @entries: an array of #GtkItemFactoryEntry<!-- -->s whose @callback members
* must by of type #GtkItemFactoryCallback1
* @callback_data: data passed to the callback functions of all entries
*
* gtk_item_factory_create_items_ac:
* @ifactory: a #GtkItemFactory
* @n_entries: the length of @entries
- * @entries: an array of #GtkItemFactoryEntry<!>s
+ * @entries: an array of #GtkItemFactoryEntry<!-- -->s
* @callback_data: data passed to the callback functions of all entries
* @callback_type: 1 if the callback functions in @entries are of type
* #GtkItemFactoryCallback1, 2 if they are of type #GtkItemFactoryCallback2
/**
* gtk_item_factory_create_menu_entries:
* @n_entries: the length of @entries
- * @entries: an array of #GtkMenuEntry<!>s
+ * @entries: an array of #GtkMenuEntry<!-- -->s
*
* Creates the menu items from the @entries.
*/
* gtk_item_factory_delete_entries:
* @ifactory: a #GtkItemFactory
* @n_entries: the length of @entries
- * @entries: an array of #GtkItemFactoryEntry<!>s
+ * @entries: an array of #GtkItemFactoryEntry<!-- -->s
*
* Deletes the menu items which were created from the @entries by the given
* item factory.
*
* The action of gtk_rc_get_style() is similar to:
* <informalexample><programlisting>
- * <!> gtk_widget_path (widget, NULL, &path, NULL);
- * <!> gtk_widget_class_path (widget, NULL, &class_path, NULL);
- * <!> gtk_rc_get_style_by_paths (gtk_widget_get_settings (widget), path, class_path,
- * <!> G_OBJECT_TYPE (widget));
+ * gtk_widget_path (widget, NULL, &path, NULL);
+ * gtk_widget_class_path (widget, NULL, &class_path, NULL);
+ * gtk_rc_get_style_by_paths (gtk_widget_get_settings (widget), path, class_path,
+ * G_OBJECT_TYPE (widget));
* </programlisting></informalexample>
*
* Return value: A style created by matching with the supplied paths,
* @window: a #GdkWindow
* @state_type: a state
* @shadow_type: type of shadow to draw
- * @points: an array of #GdkPoint<!>s
+ * @points: an array of #GdkPoint<!-- -->s
* @npoints: length of @points
* @fill: %TRUE if the polygon should be filled
*
* index is 0. If @index is too big, or @parent has no children, @iter is set
* to an invalid iterator and %FALSE is returned. @parent will remain a valid
* node after this function has been called. As a special case, if @parent is
- * %NULL, then the @n<!>th root node is set.
+ * %NULL, then the @n<!-- -->th root node is set.
*
- * Return value: %TRUE, if @parent has an @n<!>th child.
+ * Return value: %TRUE, if @parent has an @n<!-- -->th child.
**/
gboolean
gtk_tree_model_iter_nth_child (GtkTreeModel *tree_model,
*
* Here's a simple example:
* <informalexample><programlisting>
- * <!>enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
- * <!>...
- * <!>{
- * <!> GtkTreeViewColumn *column;
- * <!> GtkCellRenderer *renderer = gtk_cell_renderer_text_new ();
- * <!>
- * <!> column = gtk_tree_view_column_new_with_attributes ("Title",
- * <!> renderer,
- * <!> "text", TEXT_COLUMN,
- * <!> "foreground", COLOR_COLUMN,
- * <!> NULL);
- * <!>}
+ * enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
+ * ...
+ * {
+ * GtkTreeViewColumn *column;
+ * GtkCellRenderer *renderer = gtk_cell_renderer_text_new (<!-- -->);
+ *
+ * column = gtk_tree_view_column_new_with_attributes ("Title",
+ * renderer,
+ * "text", TEXT_COLUMN,
+ * "foreground", COLOR_COLUMN,
+ * NULL);
+ * }
* </programlisting></informalexample>
*
* Return value: A newly created #GtkTreeViewColumn.
* To reliably find the toplevel #GtkWindow, use
* gtk_widget_get_toplevel() and check if the %TOPLEVEL flags
* is set on the result.
- * <informalexample><programlisting>
- * <!>GtkWidget *toplevel = gtk_widget_get_toplevel (widget);
- * <!>if (GTK_WIDGET_TOPLEVEL (toplevel))
- * <!> {
- * <!> [ Perform action on toplevel. ]
- * <!> }
- * </programlisting></informalexample>
+ * <informalexample><programlisting>
+ * GtkWidget *toplevel = gtk_widget_get_toplevel (widget);
+ * if (GTK_WIDGET_TOPLEVEL (toplevel))
+ * {
+ * [ Perform action on toplevel. ]
+ * }
+ * </programlisting></informalexample>
*
* Return value: the topmost ancestor of @widget, or @widget itself if there's no ancestor.
**/
*
* Here is a simple example:
* <informalexample><programlisting>
- * <!> gtk_widget_push_composite_child (<!>);
- * <!> scrolled_window->hscrollbar = gtk_hscrollbar_new (hadjustment);
- * <!> gtk_widget_set_composite_name (scrolled_window->hscrollbar, "hscrollbar");
- * <!> gtk_widget_pop_composite_child (<!>);
- * <!> gtk_widget_set_parent (scrolled_window->hscrollbar,
- * <!> GTK_WIDGET (scrolled_window));
- * <!> gtk_widget_ref (scrolled_window->hscrollbar);
+ * gtk_widget_push_composite_child (<!-- -->);
+ * scrolled_window->hscrollbar = gtk_hscrollbar_new (hadjustment);
+ * gtk_widget_set_composite_name (scrolled_window->hscrollbar, "hscrollbar");
+ * gtk_widget_pop_composite_child (<!-- -->);
+ * gtk_widget_set_parent (scrolled_window->hscrollbar,
+ * GTK_WIDGET (scrolled_window));
+ * gtk_widget_ref (scrolled_window->hscrollbar);
* </programlisting></informalexample>
**/
void