Commit c779b424 authored by Matthias Clasen's avatar Matthias Clasen

Docs: use // for comments in examples

Without sgml mode, we can't escape /* as /* anymore,
so just switch to // for comments in examples.
parent e179c65d
......@@ -673,14 +673,14 @@ gdk_threads_dispatch_free (gpointer data)
* static gboolean
* idle_callback (gpointer data)
* {
* /* gdk_threads_enter(); would be needed for g_idle_add() */
* // gdk_threads_enter(); would be needed for g_idle_add()
*
* SomeWidget *self = data;
* /* do stuff with self */
* // do stuff with self
*
* self->idle_id = 0;
*
* /* gdk_threads_leave(); would be needed for g_idle_add() */
* // gdk_threads_leave(); would be needed for g_idle_add()
* return FALSE;
* }
*
......@@ -688,7 +688,7 @@ gdk_threads_dispatch_free (gpointer data)
* some_widget_do_stuff_later (SomeWidget *self)
* {
* self->idle_id = gdk_threads_add_idle (idle_callback, self)
* /* using g_idle_add() here would require thread protection in the callback */
* // using g_idle_add() here would require thread protection in the callback
* }
*
* static void
......@@ -780,7 +780,7 @@ gdk_threads_add_idle (GSourceFunc function,
* {
* SomeWidget *self = data;
*
* /* do stuff with self */
* // do stuff with self
*
* self->timeout_id = 0;
*
......
......@@ -91,14 +91,14 @@
* #ifdef GDK_WINDOWING_X11
* if (GDK_IS_X11_DISPLAY (display))
* {
* /* make X11-specific calls here */
* // make X11-specific calls here
* }
* else
* #endif
* #ifdef GDK_WINDOWING_QUARTZ
* if (GDK_IS_QUARTZ_DISPLAY (display))
* {
* /* make Quartz-specific calls here */
* // make Quartz-specific calls here
* }
* else
* #endif
......
......@@ -1678,11 +1678,11 @@ gdk_event_get_source_device (const GdkEvent *event)
*
* |[<!-- language="C" -->
* {
* /&ast; motion_event handler &ast;/
* // motion_event handler
* x = motion_event->x;
* y = motion_event->y;
* /&ast; handle (x,y) motion &ast;/
* gdk_event_request_motions (motion_event); /&ast; handles is_hint events &ast;/
* // handle (x,y) motion
* gdk_event_request_motions (motion_event); // handles is_hint events
* }
* ]|
*
......
......@@ -501,14 +501,14 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* `<Control>plus` accelerator `<Shift>` should be masked out.
*
* |[<!-- language="C" -->
* /&ast; We want to ignore irrelevant modifiers like ScrollLock &ast;/;
* // We want to ignore irrelevant modifiers like ScrollLock
* #define ALL_ACCELS_MASK (GDK_CONTROL_MASK | GDK_SHIFT_MASK | GDK_MOD1_MASK)
* gdk_keymap_translate_keyboard_state (keymap, event->hardware_keycode,
* event->state, event->group,
* &keyval, NULL, NULL, &consumed);
* if (keyval == GDK_PLUS &&
* (event->state & ~consumed & ALL_ACCELS_MASK) == GDK_CONTROL_MASK)
* /&ast; Control was pressed &ast;/
* // Control was pressed
* ]|
*
* An older interpretation @consumed_modifiers was that it contained
......@@ -516,10 +516,10 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* this allowed accelerators to be stored with irrelevant consumed
* modifiers, by doing:
* |[<!-- language="C" -->
* /&ast; XXX Don’t do this XXX &ast;/
* // XXX Don’t do this XXX
* if (keyval == accel_keyval &&
* (event->state & ~consumed & ALL_ACCELS_MASK) == (accel_mods & ~consumed))
* /&ast; Accelerator was pressed &ast;/
* // Accelerator was pressed
* ]|
*
* However, this did not work if multi-modifier combinations were
......
......@@ -52,14 +52,14 @@
* #ifdef GDK_WINDOWING_WAYLAND
* if (GDK_IS_WAYLAND_DISPLAY (display))
* {
* /&ast; make Wayland-specific calls here &ast;/
* // make Wayland-specific calls here
* }
* else
* #endif
* #ifdef GDK_WINDOWING_X11
* if (GDK_IS_X11_DISPLAY (display))
* {
* /&ast; make X11-specific calls here &ast;/
* // make X11-specific calls here
* }
* else
* #endif
......
......@@ -64,14 +64,14 @@
* #ifdef GDK_WINDOWING_X11
* if (GDK_IS_X11_DISPLAY (display))
* {
* /&ast; make X11-specific calls here &ast;/
* // make X11-specific calls here
* }
* else
* #endif
* #ifdef GDK_WINDOWING_QUARTZ
* if (GDK_IS_QUARTZ_DISPLAY (display))
* {
* /&ast; make Quartz-specific calls here &ast/
* // make Quartz-specific calls here
* }
* else
* #endif
......
......@@ -406,7 +406,7 @@ create_menu_item (GtkAction *action)
* GSList *group = NULL;
* GtkRadioAction *action;
*
* while (/&ast; more actions to add &ast;/)
* while ( ...more actions to add... /)
* {
* action = gtk_radio_action_new (...);
*
......@@ -496,7 +496,7 @@ gtk_radio_action_set_group (GtkRadioAction *action,
* GtkRadioAction *action;
* GtkRadioAction *last_action;
*
* while (/&ast; more actions to add &ast;/)
* while ( ...more actions to add... /)
* {
* action = gtk_radio_action_new (...);
*
......
......@@ -496,7 +496,7 @@ static const GtkStockItem builtin_items [] =
* return (gchar*)g_dpgettext2 (GETTEXT_PACKAGE, msgctxt, msgid);
* }
*
* /&ast; ... &ast;/
* ...
*
* gtk_stock_add (items, G_N_ELEMENTS (items));
* gtk_stock_set_translate_func ("odd-item-domain", my_translate_func, "odd items");
......
......@@ -72,21 +72,20 @@
* GtkWidget *save_item;
* GtkAccelGroup *accel_group;
*
* /&ast; Create a GtkAccelGroup and add it to the window. &ast;/
* // Create a GtkAccelGroup and add it to the window.
* accel_group = gtk_accel_group_new ();
* gtk_window_add_accel_group (GTK_WINDOW (window), accel_group);
*
* /&ast; Create the menu item using the convenience function. &ast;/
* // Create the menu item using the convenience function.
* save_item = gtk_menu_item_new_with_label ("Save");
* gtk_widget_show (save_item);
* gtk_container_add (GTK_CONTAINER (menu), save_item);
*
* /&ast; Now add the accelerator to the GtkMenuItem. Note that since we
* &ast; called gtk_menu_item_new_with_label() to create the GtkMenuItem
* &ast; the GtkAccelLabel is automatically set up to display the
* &ast; GtkMenuItem accelerators. We just need to make sure we use
* &ast; GTK_ACCEL_VISIBLE here.
* &ast;/
* // Now add the accelerator to the GtkMenuItem. Note that since we
* // called 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,
* GDK_KEY_s, GDK_CONTROL_MASK, GTK_ACCEL_VISIBLE);
* ]|
......
......@@ -104,9 +104,8 @@
* GtkCellRenderer *cell;
*
* cell = gtk_cell_renderer_pixbuf_new ();
* /&ast; The following call causes the default cell area for combo boxes,
* &ast; a GtkCellAreaBox, to be instantiated
* &ast;/
* // The following call causes the default cell area for combo boxes,
* // a GtkCellAreaBox, to be instantiated
* gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (b), cell, FALSE);
* ...
* }
......@@ -114,9 +113,7 @@
* GtkWidget *
* my_combo_box_new (GtkCellArea *area)
* {
* /&ast; This call is going to cause a warning
* &ast; about area being ignored
* &ast;/
* // This call is going to cause a warning about area being ignored
* return g_object_new (MY_TYPE_COMBO_BOX, "cell-area", area, NULL);
* }
* ]|
......
......@@ -259,7 +259,7 @@ gtk_cell_renderer_class_init (GtkCellRendererClass *class)
* {
* GtkEntry *entry = GTK_ENTRY (editable);
*
* /&ast; ... create a GtkEntryCompletion &ast;/
* // ... create a GtkEntryCompletion
*
* gtk_entry_set_completion (entry, completion);
* }
......
......@@ -200,7 +200,7 @@ gtk_css_custom_property_create_initial_value (GParamSpec *pspec)
* the engine property, either in a previous rule or within the same
* one.
* |[
* &ast; {
* * {
* engine: someengine;
* -SomeEngine-custom-property: 2;
* }
......
......@@ -115,38 +115,47 @@
* the two selectors. E.g. `GtkNotebook > GtkLabel` matches
* GtkLabel widgets that are direct children of a GtkNotebook.
*
* An example of widget classes and names in selectors:
* ## Examples of widget classes and names in selectors
*
* Theme labels that are descendants of a window:
* |[
* /&ast; Theme labels that are descendants of a window &ast;/
* GtkWindow GtkLabel {
* background-color: #898989
* }
* ]|
*
* /&ast; Theme notebooks, and anything that’s within these &ast;/
* Theme notebooks, and anything that’s within these:
* |[
* GtkNotebook {
* background-color: #a939f0
* }
* ]|
*
* /&ast; Theme combo boxes, and entries that
* are direct children of a notebook &ast;/
* Theme combo boxes, and entries that are direct children of a notebook:
* |[
* GtkComboBox,
* GtkNotebook > GtkEntry {
* color: @fg_color;
* background-color: #1209a2
* }
* ]|
*
* /&ast; Theme any widget within a GtkBin &ast;/
* Theme any widget within a GtkBin:
* |[
* GtkBin * {
* font: Sans 20
* }
* ]|
*
* /&ast; Theme a label named title-label &ast;/
* Theme a label named title-label:
* |[
* GtkLabel#title-label {
* font: Sans 15
* }
* ]|
*
* /&ast; Theme any widget named main-entry &ast;/
* Theme any widget named main-entry:
* |[
* #main-entry {
* background-color: #f0a810
* }
......@@ -166,14 +175,17 @@
* a string as a widget class name if it contains any uppercase characters
* (which should work for more widgets with names like GtkLabel).
*
* An example for style classes in selectors:
* ## Examples for style classes in selectors
*
* Theme all widgets defining the class entry:
* |[
* /&ast; Theme all widgets defining the class entry &ast;/
* .entry {
* color: #39f1f9;
* }
* ]|
*
* /&ast; Theme spinbuttons’ entry &ast;/
* Theme spinbuttons’ entry:
* |[
* GtkSpinButton.entry {
* color: #900185
* }
......@@ -197,20 +209,25 @@
* for a list of all regions
* used by GTK+ widgets.
*
* An example for regions in selectors:
* ## Examples for regions in selectors
*
* Theme any label within a notebook:
* |[
* /&ast; Theme any label within a notebook &ast;/
* GtkNotebook GtkLabel {
* color: #f90192;
* }
* ]|
*
* /&ast; Theme labels within notebook tabs &ast;/
* Theme labels within notebook tabs:
* |[
* GtkNotebook tab GtkLabel {
* color: #703910;
* }
* ]|
*
* /&ast; Theme labels in the any first notebook
* tab, both selectors are equivalent &ast;/
* Theme labels in the any first notebook tab, both selectors are
* equivalent:
* |[
* GtkNotebook tab:nth-child(first) GtkLabel,
* GtkNotebook tab:first-child GtkLabel {
* color: #89d012;
......@@ -223,37 +240,47 @@
* are :active, :prelight (or :hover), :insensitive, :selected, :focused
* and :inconsistent.
*
* And example for styling specific widget states:
* ## Examples for styling specific widget states
*
* Theme active (pressed) buttons:
* |[
* /&ast; Theme active (pressed) buttons &ast;/
* GtkButton:active {
* background-color: #0274d9;
* }
* ]|
*
* /&ast; Theme buttons with the mouse pointer on it,
* both are equivalent &ast;/
* Theme buttons with the mouse pointer on it, both are equivalent:
* |[
* GtkButton:hover,
* GtkButton:prelight {
* background-color: #3085a9;
* }
* ]|
*
* /&ast; Theme insensitive widgets, both are equivalent &ast;/
* Theme insensitive widgets, both are equivalent:
* |[
* :insensitive,
* *:insensitive {
* background-color: #320a91;
* }
* ]|
*
* /&ast; Theme selection colors in entries &ast;/
* Theme selection colors in entries:
* |[
* GtkEntry:selected {
* background-color: #56f9a0;
* }
* ]|
*
* /&ast; Theme focused labels &ast;/
* Theme focused labels:
* |[
* GtkLabel:focused {
* background-color: #b4940f;
* }
* ]|
*
* /&ast; Theme inconsistent checkbuttons &ast;/
* Theme inconsistent checkbuttons:
* |[
* GtkCheckButton:inconsistent {
* background-color: #20395a;
* }
......
......@@ -100,14 +100,14 @@
*
* An example for simple GtkDialog usage:
* |[<!-- language="C" -->
* /&ast; Function to open a dialog box with a message &ast;/
* // Function to open a dialog box with a message
* void
* quick_message (GtkWindow *parent, gchar *message)
* {
* GtkWidget *dialog, *label, *content_area;
* GtkDialogFlags flags;
*
* /&ast; Create the widgets &ast;/
* // Create the widgets
* flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* dialog = gtk_dialog_new_with_buttons ("Message",
* parent,
......@@ -118,15 +118,14 @@
* content_area = gtk_dialog_get_content_area (GTK_DIALOG (dialog));
* label = gtk_label_new (message);
*
* /&ast; Ensure that the dialog box is destroyed when the user
* responds &ast;/
* // Ensure that the dialog box is destroyed when the user responds
*
* g_signal_connect_swapped (dialog,
* "response",
* G_CALLBACK (gtk_widget_destroy),
* dialog);
*
* /&ast; Add the label, and show everything we’ve added &ast;/
* // Add the label, and show everything we’ve added
*
* gtk_container_add (GTK_CONTAINER (content_area), label);
* gtk_widget_show_all (dialog);
......
......@@ -86,7 +86,7 @@
* return FALSE;
* }
* [...]
* GtkWidget &ast;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), "draw",
* G_CALLBACK (draw_callback), NULL);
......
......@@ -60,11 +60,11 @@
*
* if (gtk_expander_get_expanded (expander))
* {
* /&ast; Show or create widgets &ast;/
* // Show or create widgets
* }
* else
* {
* /&ast; Hide or destroy widgets &ast;/
* // Hide or destroy widgets
* }
* }
* ]|
......
......@@ -722,12 +722,12 @@ gtk_file_chooser_get_filename (GtkFileChooser *chooser)
* |[<!-- language="C" -->
* if (document_is_new)
* {
* /&ast; the user just created a new document &ast;/
* // the user just created a new document
* gtk_file_chooser_set_current_name (chooser, "Untitled document");
* }
* else
* {
* /&ast; the user edited an existing document &ast;/
* // the user edited an existing document
* gtk_file_chooser_set_filename (chooser, existing_filename);
* }
* ]|
......@@ -1074,12 +1074,12 @@ gtk_file_chooser_get_uri (GtkFileChooser *chooser)
* |[<!-- language="C" -->
* if (document_is_new)
* {
* /&ast; the user just created a new document &ast;/
* // the user just created a new document
* gtk_file_chooser_set_current_name (chooser, "Untitled document");
* }
* else
* {
* /&ast; the user edited an existing document &ast;/
* // the user edited an existing document
* gtk_file_chooser_set_uri (chooser, existing_uri);
* }
* ]|
......@@ -1440,13 +1440,13 @@ gtk_file_chooser_get_files (GtkFileChooser *chooser)
* |[<!-- language="C" -->
* if (document_is_new)
* {
* /&ast; the user just created a new document &ast;/
* // the user just created a new document
* gtk_file_chooser_set_current_folder_file (chooser, default_file_for_saving);
* gtk_file_chooser_set_current_name (chooser, "Untitled document");
* }
* else
* {
* /&ast; the user edited an existing document &ast;/
* // the user edited an existing document
* gtk_file_chooser_set_file (chooser, existing_file);
* }
* ]|
......
......@@ -32,7 +32,7 @@
* types; e.g. a filter for text/plain also matches a file with mime
* type application/rtf, since application/rtf is a subclass of
* text/plain. Note that #GtkFileFilter allows wildcards for the
* subtype of a mime type, so you can e.g. filter for image/&ast;.
* subtype of a mime type, so you can e.g. filter for image/\*.
*
* Normally, filters are used by adding them to a #GtkFileChooser,
* see gtk_file_chooser_add_filter(), but it is also possible
......@@ -52,7 +52,7 @@
* <object class="GtkFileFilter">
* <mime-types>
* <mime-type>text/plain</mime-type>
* <mime-type>image/&ast;</mime-type>
* <mime-type>image/ *</mime-type>
* </mime-types>
* <patterns>
* <pattern>*.txt</pattern>
......
......@@ -120,9 +120,9 @@
*
* icon_theme = gtk_icon_theme_get_default ();
* pixbuf = gtk_icon_theme_load_icon (icon_theme,
* "my-icon-name", /&ast; icon name &ast;/
* 48, /&ast; icon size &ast;/
* 0, /&ast; flags &ast;/
* "my-icon-name", // icon name
* 48, // icon size
* 0, // flags
* &error);
* if (!pixbuf)
* {
......@@ -131,7 +131,7 @@
* }
* else
* {
* /&ast; Use the pixbuf &ast;/
* // Use the pixbuf
* g_object_unref (pixbuf);
* }
* ]|
......
......@@ -86,12 +86,9 @@
* g_print ("Event box clicked at coordinates %f,%f\n",
* event->x, event->y);
*
* /&ast; Returning TRUE means we handled the event,
* &ast; so the signal emission should be stopped
* &ast; (don’t call any further callbacks that
* &ast; may be connected). Return FALSE to
* &ast; continue invoking callbacks.
* &ast;/
* // Returning TRUE means we handled the event, so the signal
* // emission should be stopped (don’t call any further callbacks
* // that may be connected). Return FALSE to continue invoking callbacks.
* return TRUE;
* }
*
......
......@@ -74,7 +74,7 @@
*
* A simple example for using a GtkInfoBar:
* |[<!-- language="C" -->
* /&ast; set up info bar &ast;/
* // set up info bar
* GtkWidget *widget;
* GtkInfoBar *bar;
*
......@@ -98,9 +98,9 @@
* widget,
* 0, 2, 1, 1);
*
* /&ast; ... &ast;/
* ...
*
* /&ast; show an error message &ast;/
* // show an error message
* gtk_label_set_text (GTK_LABEL (message_label), message);
* gtk_info_bar_set_message_type (bar,
* GTK_MESSAGE_ERROR);
......
......@@ -107,7 +107,7 @@
* the label is inside a button:
*
* |[<!-- language="C" -->
* /&ast; Pressing Alt+H will activate this button &ast;/
* // Pressing Alt+H will activate this button
* button = gtk_button_new ();
* label = gtk_label_new_with_mnemonic ("_Hello");
* gtk_container_add (GTK_CONTAINER (button), label);
......@@ -117,7 +117,7 @@
* already inside:
*
* |[<!-- language="C" -->
* /&ast; Pressing Alt+H will activate this button &ast;/
* // Pressing Alt+H will activate this button
* button = gtk_button_new_with_mnemonic ("_Hello");
* ]|
*
......@@ -126,7 +126,7 @@
* gtk_label_set_mnemonic_widget():
*
* |[<!-- language="C" -->
* /&ast; Pressing Alt+H will focus the entry &ast;/
* // Pressing Alt+H will focus the entry
* entry = gtk_entry_new ();
* label = gtk_label_new_with_mnemonic ("_Hello");
* gtk_label_set_mnemonic_widget (GTK_LABEL (label), entry);
......
......@@ -79,7 +79,7 @@
*
* some_data = get_some_data (i);
*
* /&ast; Add a new row to the model &ast;/
* // Add a new row to the model
* gtk_list_store_append (list_store, &iter);
* gtk_list_store_set (list_store, &iter,
* COLUMN_STRING, some_data,
......@@ -87,13 +87,12 @@
* COLUMN_BOOLEAN, FALSE,
* -1);
*
* /&ast; As the store will keep a copy of
* &ast; the string internally, we free some_data.
* &ast;/
* // As the store will keep a copy of the string internally,
* // we free some_data.
* g_free (some_data);
* }
*
* /&ast; Modify a particular row &ast;/
* // Modify a particular row
* path = gtk_tree_path_new_from_string ("4");
* gtk_tree_model_get_iter (GTK_TREE_MODEL (list_store),
* &iter,
......
......@@ -59,27 +59,27 @@
* int
* main (int argc, char **argv)
* {
* /&ast; Initialize i18n support with
* bindtextdomain(), etc. &ast;/
* // Initialize i18n support with bindtextdomain(), etc.
*
* ...
*
* /&ast; Initialize the widget set &ast;/
* // Initialize the widget set
* gtk_init (&argc, &argv);
*
* /&ast; Create the main window &ast;/
* // Create the main window
* mainwin = gtk_window_new (GTK_WINDOW_TOPLEVEL);
*
* /&ast; Set up our GUI elements &ast;/
* // Set up our GUI elements
*
* ...
*
* /&ast; Show the application window &ast;/
* // Show the application window
* gtk_widget_show_all (mainwin);
*
* /&ast; Enter the main event loop, and
* wait for user interaction &ast;/
* // Enter the main event loop, and wait for user interaction
* gtk_main ();
*
* /&ast; The user lost interest &ast;/
* // The user lost interest
* return 0;
* }
* ]|
......@@ -1251,12 +1251,12 @@ gtk_main_quit (void)
* ## Updating the UI during a long computation
*
* |[<!-- language="C" -->
* /&ast; computation going on... &ast;/
* // computation going on...
*
* while (gtk_events_pending ())
* gtk_main_iteration ();
*
* /&ast; ...computation continued &ast;/
* // ...computation continued
* ]|
*
* Returns: %TRUE if any events are pending, %FALSE otherwise
......
......@@ -84,8 +84,8 @@
* filename,
* g_strerror (errno));
*
* /&ast; Destroy the dialog when the user responds to it
* (e.g. clicks a button) &ast;/
* // Destroy the dialog when the user responds to it
* // (e.g. clicks a button)
*
* g_signal_connect_swapped (dialog, "response",
* G_CALLBACK (gtk_widget_destroy),
......
......@@ -78,17 +78,17 @@
* box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 2);
* gtk_box_set_homogeneous (GTK_BOX (box), TRUE);
*
* /&ast; Create a radio button with a GtkEntry widget &ast;/
* // Create a radio button with a GtkEntry widget
* radio1 = gtk_radio_button_new (NULL);
* entry = gtk_entry_new ();
* gtk_container_add (GTK_CONTAINER (radio1), entry);
*
*
* /&ast; Create a radio button with a label &ast;/
* // Create a radio button with a label
* radio2 = gtk_radio_button_new_with_label_from_widget (GTK_RADIO_BUTTON (radio1),
* "I’m the second radio button.");
*
* /&ast; Pack them into a box, then show all the widgets &ast;/
* // Pack them into a box, then show all the widgets
* gtk_box_pack_start (GTK_BOX (box), radio1, TRUE, TRUE, 2);
* gtk_box_pack_start (GTK_BOX (box), radio2, TRUE, TRUE, 2);
* gtk_container_add (GTK_CONTAINER (window), box);
......@@ -358,7 +358,7 @@ gtk_radio_button_set_group (GtkRadioButton *radio_button,
* GtkRadioButton *radio_button;
* GtkRadioButton *last_button;
*
* while (/&ast; more buttons to add &ast;/)
* while ( ...more buttons to add... )
* {
* radio_button = gtk_radio_button_new (...);
*
......
......@@ -32,7 +32,7 @@
* types; e.g. a filter for text/plain also matches a file with mime
* type application/rtf, since application/rtf is a subclass of text/plain.
* Note that #GtkRecentFilter allows wildcards for the subtype of a
* mime type, so you can e.g. filter for image/&ast;.
* mime type, so you can e.g. filter for image/\*.
*
* Normally, filters are used by adding them to a #GtkRecentChooser,
* see gtk_recent_chooser_add_filter(), but it is also possible to
......
......@@ -67,7 +67,7 @@
* }
* else
* {
* /&ast; Use the info object &ast;/
* // Use the info object
* gtk_recent_info_unref (info);
* }
* ]|
......
......@@ -89,7 +89,7 @@
* |[<!-- language="C" -->
* gtk_init (&argc, &argv);
*
* /&ast; make sure the type is realized &ast;/
* // make sure the type is realized
* g_type_class_unref (g_type_class_ref (GTK_TYPE_IMAGE_MENU_ITEM));
*
* g_object_set (gtk_settings_get_default (), "gtk-enable-animations", FALSE, NULL);
......
......@@ -75,9 +75,8 @@
* gtk_widget_show (socket);
* gtk_container_add (GTK_CONTAINER (parent), socket);
*
* /&ast; The following call is only necessary if one of
* * the ancestors of the socket is not yet visible.
* &ast;/
* // The following call is only necessary if one of