AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Docs: Use markdown for lists

Browse Source 
This greatly reduces the amount of xml in the docs.
This commit is contained in:
Matthias Clasen 2014-02-02 01:07:39 -05:00
parent 09d1b28249
commit 30cc1512e6
19 changed files with 219 additions and 393 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
gdk/gdkcursor.c
View File

@ -224,62 +224,24 @@ gdk_cursor_get_cursor_type (GdkCursor *cursor)
* *
* Creates a new cursor from the set of builtin cursors. * Creates a new cursor from the set of builtin cursors.
* Some useful ones are: * Some useful ones are:
* <itemizedlist> * - <inlinegraphic format="PNG" fileref="right_ptr.png"></inlinegraphic> #GDK_RIGHT_PTR (right-facing arrow)
* <listitem><para> * - <inlinegraphic format="PNG" fileref="crosshair.png"></inlinegraphic> #GDK_CROSSHAIR (crosshair)
* <inlinegraphic format="PNG" fileref="right_ptr.png"></inlinegraphic> #GDK_RIGHT_PTR (right-facing arrow) * - <inlinegraphic format="PNG" fileref="xterm.png"></inlinegraphic> #GDK_XTERM (I-beam)
* </para></listitem> * - <inlinegraphic format="PNG" fileref="watch.png"></inlinegraphic> #GDK_WATCH (busy)
* <listitem><para> * - <inlinegraphic format="PNG" fileref="fleur.png"></inlinegraphic> #GDK_FLEUR (for moving objects)
* <inlinegraphic format="PNG" fileref="crosshair.png"></inlinegraphic> #GDK_CROSSHAIR (crosshair) * - <inlinegraphic format="PNG" fileref="hand1.png"></inlinegraphic> #GDK_HAND1 (a right-pointing hand)
* </para></listitem> * - <inlinegraphic format="PNG" fileref="hand2.png"></inlinegraphic> #GDK_HAND2 (a left-pointing hand)
* <listitem><para> * - <inlinegraphic format="PNG" fileref="left_side.png"></inlinegraphic> #GDK_LEFT_SIDE (resize left side)
* <inlinegraphic format="PNG" fileref="xterm.png"></inlinegraphic> #GDK_XTERM (I-beam) * - <inlinegraphic format="PNG" fileref="right_side.png"></inlinegraphic> #GDK_RIGHT_SIDE (resize right side)
* </para></listitem> * - <inlinegraphic format="PNG" fileref="top_left_corner.png"></inlinegraphic> #GDK_TOP_LEFT_CORNER (resize northwest corner)
* <listitem><para> * - <inlinegraphic format="PNG" fileref="top_right_corner.png"></inlinegraphic> #GDK_TOP_RIGHT_CORNER (resize northeast corner)
* <inlinegraphic format="PNG" fileref="watch.png"></inlinegraphic> #GDK_WATCH (busy) * - <inlinegraphic format="PNG" fileref="bottom_left_corner.png"></inlinegraphic> #GDK_BOTTOM_LEFT_CORNER (resize southwest corner)
* </para></listitem> * - <inlinegraphic format="PNG" fileref="bottom_right_corner.png"></inlinegraphic> #GDK_BOTTOM_RIGHT_CORNER (resize southeast corner)
* <listitem><para> * - <inlinegraphic format="PNG" fileref="top_side.png"></inlinegraphic> #GDK_TOP_SIDE (resize top side)
* <inlinegraphic format="PNG" fileref="fleur.png"></inlinegraphic> #GDK_FLEUR (for moving objects) * - <inlinegraphic format="PNG" fileref="bottom_side.png"></inlinegraphic> #GDK_BOTTOM_SIDE (resize bottom side)
* </para></listitem> * - <inlinegraphic format="PNG" fileref="sb_h_double_arrow.png"></inlinegraphic> #GDK_SB_H_DOUBLE_ARROW (move vertical splitter)
* <listitem><para> * - <inlinegraphic format="PNG" fileref="sb_v_double_arrow.png"></inlinegraphic> #GDK_SB_V_DOUBLE_ARROW (move horizontal splitter)
* <inlinegraphic format="PNG" fileref="hand1.png"></inlinegraphic> #GDK_HAND1 (a right-pointing hand) * - #GDK_BLANK_CURSOR (Blank cursor). Since 2.16
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="hand2.png"></inlinegraphic> #GDK_HAND2 (a left-pointing hand)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="left_side.png"></inlinegraphic> #GDK_LEFT_SIDE (resize left side)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="right_side.png"></inlinegraphic> #GDK_RIGHT_SIDE (resize right side)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="top_left_corner.png"></inlinegraphic> #GDK_TOP_LEFT_CORNER (resize northwest corner)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="top_right_corner.png"></inlinegraphic> #GDK_TOP_RIGHT_CORNER (resize northeast corner)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="bottom_left_corner.png"></inlinegraphic> #GDK_BOTTOM_LEFT_CORNER (resize southwest corner)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="bottom_right_corner.png"></inlinegraphic> #GDK_BOTTOM_RIGHT_CORNER (resize southeast corner)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="top_side.png"></inlinegraphic> #GDK_TOP_SIDE (resize top side)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="bottom_side.png"></inlinegraphic> #GDK_BOTTOM_SIDE (resize bottom side)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="sb_h_double_arrow.png"></inlinegraphic> #GDK_SB_H_DOUBLE_ARROW (move vertical splitter)
* </para></listitem>
* <listitem><para>
* <inlinegraphic format="PNG" fileref="sb_v_double_arrow.png"></inlinegraphic> #GDK_SB_V_DOUBLE_ARROW (move horizontal splitter)
* </para></listitem>
* <listitem><para>
* #GDK_BLANK_CURSOR (Blank cursor). Since 2.16
* </para></listitem>
* </itemizedlist>
* *
* Return value: a new #GdkCursor * Return value: a new #GdkCursor
* *

13
gdk/gdkdisplay.c
View File

@ -44,15 +44,10 @@
* @Title: GdkDisplay * @Title: GdkDisplay
* *
* #GdkDisplay objects purpose are two fold: * #GdkDisplay objects purpose are two fold:
* <itemizedlist> *
* <listitem> * - To manage and provide information about input devices (pointers and keyboards)
* To manage and provide information about input devices (pointers *
* and keyboards) * - To manage and provide information about the available #GdkScreens
* </listitem>
* <listitem>
* To manage and provide information about the available #GdkScreens
* </listitem>
* </itemizedlist>
* *
* GdkDisplay objects are the GDK representation of an X Display, * GdkDisplay objects are the GDK representation of an X Display,
* which can be described as a workstation consisting of * which can be described as a workstation consisting of

18
gdk/gdkrgba.c
View File

@ -141,22 +141,12 @@ parse_rgb_value (const gchar *str,
* the @red, @green, @blue and @alpha fields of the @rgba #GdkRGBA. * the @red, @green, @blue and @alpha fields of the @rgba #GdkRGBA.
* *
* The string can be either one of: * The string can be either one of:
* <itemizedlist> * - A standard name (Taken from the X11 rgb.txt file).
* <listitem> * - A hex value in the form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb'
* A standard name (Taken from the X11 rgb.txt file).
* </listitem>
* <listitem>
* A hex value in the form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb'
* or '&num;rrrrggggbbbb' * or '&num;rrrrggggbbbb'
* </listitem> * - A RGB color in the form 'rgb(r,g,b)' (In this case the color will
* <listitem>
* A RGB color in the form 'rgb(r,g,b)' (In this case the color will
* have full opacity) * have full opacity)
* </listitem> * - A RGBA color in the form 'rgba(r,g,b,a)'
* <listitem>
* A RGBA color in the form 'rgba(r,g,b,a)'
* </listitem>
* </itemizedlist>
* *
* Where 'r', 'g', 'b' and 'a' are respectively the red, green, blue and * Where 'r', 'g', 'b' and 'a' are respectively the red, green, blue and
* alpha color values. In the last two cases, r g and b are either integers * alpha color values. In the last two cases, r g and b are either integers

29
gtk/gtkdrawingarea.c
View File

@ -38,34 +38,19 @@
* elements. It's essentially a blank widget; you can draw on it. After * elements. It's essentially a blank widget; you can draw on it. After
* creating a drawing area, the application may want to connect to: * creating a drawing area, the application may want to connect to:
* *
* <itemizedlist> * - Mouse and button press signals to respond to input from
* <listitem>
* <para>
* Mouse and button press signals to respond to input from
* the user. (Use gtk_widget_add_events() to enable events * the user. (Use gtk_widget_add_events() to enable events
* you wish to receive.) * you wish to receive.)
* </para> *
* </listitem> * - The #GtkWidget::realize signal to take any necessary actions
* <listitem>
* <para>
* The #GtkWidget::realize signal to take any necessary actions
* when the widget is instantiated on a particular display. * when the widget is instantiated on a particular display.
* (Create GDK resources in response to this signal.) * (Create GDK resources in response to this signal.)
* </para> *
* </listitem> * - The #GtkWidget::configure-event signal to take any necessary
* <listitem>
* <para>
* The #GtkWidget::configure-event signal to take any necessary
* actions when the widget changes size. * actions when the widget changes size.
* </para> *
* </listitem> * - The #GtkWidget::draw signal to handle redrawing the
* <listitem>
* <para>
* The #GtkWidget::draw signal to handle redrawing the
* contents of the widget. * contents of the widget.
* </para>
* </listitem>
* </itemizedlist>
* *
* The following code portion demonstrates using a drawing * The following code portion demonstrates using a drawing
* area to display a circle in the normal widget foreground * area to display a circle in the normal widget foreground

8
gtk/gtkentry.c
View File

@ -1599,11 +1599,9 @@ gtk_entry_class_init (GtkEntryClass *class)
* the variant with the Shift modifier extends the selection, * the variant with the Shift modifier extends the selection,
* the variant without the Shift modifer does not. * the variant without the Shift modifer does not.
* There are too many key combinations to list them all here. * There are too many key combinations to list them all here.
* <itemizedlist> * - Arrow keys move by individual characters/lines
* <listitem>Arrow keys move by individual characters/lines</listitem> * - Ctrl-arrow key combinations move by words/paragraphs
* <listitem>Ctrl-arrow key combinations move by words/paragraphs</listitem> * - Home/End keys move to the ends of the buffer
* <listitem>Home/End keys move to the ends of the buffer</listitem>
* </itemizedlist>
*/ */
signals[MOVE_CURSOR] = signals[MOVE_CURSOR] =
g_signal_new (I_("move-cursor"), g_signal_new (I_("move-cursor"),

65
gtk/gtkfilechooserdialog.c
View File

@ -110,26 +110,23 @@
* ]| * ]|
* </para> * </para>
* </example> * </example>
* <section id="gtkfilechooserdialog-setting-up"> *
* <title>Setting up a file chooser dialog</title> * ## Setting up a file chooser dialog
*
* <para id="gtkfilechooserdialog-setting-up">
* There are various cases in which you may need to use a #GtkFileChooserDialog: * There are various cases in which you may need to use a #GtkFileChooserDialog:
* <itemizedlist><listitem>To select a file for opening. Use *
* #GTK_FILE_CHOOSER_ACTION_OPEN. * - To select a file for opening. Use #GTK_FILE_CHOOSER_ACTION_OPEN.
* </listitem> *
* <listitem>To save a file for the first time. Use * - To save a file for the first time. Use #GTK_FILE_CHOOSER_ACTION_SAVE,
* #GTK_FILE_CHOOSER_ACTION_SAVE, and suggest a name such as * and suggest a name such as "Untitled" with gtk_file_chooser_set_current_name().
* "Untitled" with gtk_file_chooser_set_current_name(). *
* </listitem> * - To save a file under a different name. Use #GTK_FILE_CHOOSER_ACTION_SAVE,
* <listitem>To save a file under a different name. Use * and set the existing filename with gtk_file_chooser_set_filename().
* #GTK_FILE_CHOOSER_ACTION_SAVE, and set the existing filename *
* with gtk_file_chooser_set_filename(). * - To choose a folder instead of a file. Use #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
* </listitem> *
* <listitem>To choose a folder instead of a file. Use * Note that old versions of the file chooser's documentation suggested
* #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
* </listitem></itemizedlist>
* <note>
* <para>
* Old versions of the file chooser's documentation suggested
* using gtk_file_chooser_set_current_folder() in various * using gtk_file_chooser_set_current_folder() in various
* situations, with the intention of letting the application * situations, with the intention of letting the application
* suggest a reasonable default folder. This is no longer * suggest a reasonable default folder. This is no longer
@ -139,16 +136,14 @@
* when it is appropriate to use gtk_file_chooser_set_filename(), * when it is appropriate to use gtk_file_chooser_set_filename(),
* i.e. when you are doing a Save As command and you already * i.e. when you are doing a Save As command and you already
* have a file saved somewhere. * have a file saved somewhere.
* </para> *
* </note> * ## Response Codes
* </section> *
* <section id="gtkfilechooserdialog-response-codes"> * <para id="gtkfilechooserdialog-response-codes">
* <title>Response Codes</title>
* #GtkFileChooserDialog inherits from #GtkDialog, so buttons that * #GtkFileChooserDialog inherits from #GtkDialog, so buttons that
* go in its action area have response codes such as * go in its action area have response codes such as
* #GTK_RESPONSE_ACCEPT and #GTK_RESPONSE_CANCEL. For example, you * #GTK_RESPONSE_ACCEPT and #GTK_RESPONSE_CANCEL. For example, you
* could call gtk_file_chooser_dialog_new() as follows: * could call gtk_file_chooser_dialog_new() as follows:
* <para>
* |[ * |[
* GtkWidget *dialog; * GtkWidget *dialog;
* *
@ -160,6 +155,8 @@
* NULL); * NULL);
* ]| * ]|
* </para> * </para>
*
* <para id="gtkfilechooserdialog-responses">
* This will create buttons for "Cancel" and "Open" that use stock * This will create buttons for "Cancel" and "Open" that use stock
* response identifiers from #GtkResponseType. For most dialog * response identifiers from #GtkResponseType. For most dialog
* boxes you can use your own custom response codes rather than the * boxes you can use your own custom response codes rather than the
@ -167,27 +164,21 @@
* its "accept"-type action, e.g. an "Open" or "Save" button, * its "accept"-type action, e.g. an "Open" or "Save" button,
* will have one of the following response * will have one of the following response
* codes: * codes:
* <para> * - #GTK_RESPONSE_ACCEPT
* <simplelist id="gtkfilechooserdialog-responses"> * - #GTK_RESPONSE_OK
* <member>#GTK_RESPONSE_ACCEPT</member> * - #GTK_RESPONSE_YES
* <member>#GTK_RESPONSE_OK</member> * - #GTK_RESPONSE_APPLY
* <member>#GTK_RESPONSE_YES</member>
* <member>#GTK_RESPONSE_APPLY</member>
* </simplelist>
* </para> * </para>
*
* This is because #GtkFileChooserDialog must intercept responses * This is because #GtkFileChooserDialog must intercept responses
* and switch to folders if appropriate, rather than letting the * and switch to folders if appropriate, rather than letting the
* dialog terminate &mdash; the implementation uses these known * dialog terminate &mdash; the implementation uses these known
* response codes to know which responses can be blocked if * response codes to know which responses can be blocked if
* appropriate. * appropriate.
* <para> *
* <note>
* To summarize, make sure you use a * To summarize, make sure you use a
* <link linkend="gtkfilechooserdialog-responses">stock response code</link> * <link linkend="gtkfilechooserdialog-responses">stock response code</link>
* when you use #GtkFileChooserDialog to ensure proper operation. * when you use #GtkFileChooserDialog to ensure proper operation.
* </note>
* </para>
* </section>
*/ */

17
gtk/gtkfixed.c
View File

@ -37,23 +37,18 @@
* results in broken applications. With #GtkFixed, the following * results in broken applications. With #GtkFixed, the following
* things will result in truncated text, overlapping widgets, and * things will result in truncated text, overlapping widgets, and
* other display bugs: * other display bugs:
* <itemizedlist> *
* <listitem><para> * - Themes, which may change widget sizes.
* Themes, which may change widget sizes. *
* </para></listitem> * - Fonts other than the one you used to write the app will of course
* <listitem><para>
* Fonts other than the one you used to write the app will of course
* change the size of widgets containing text; keep in mind that * change the size of widgets containing text; keep in mind that
* users may use a larger font because of difficulty reading the * users may use a larger font because of difficulty reading the
* default, or they may be using Windows or the framebuffer port of * default, or they may be using Windows or the framebuffer port of
* GTK+, where different fonts are available. * GTK+, where different fonts are available.
* </para></listitem> *
* <listitem><para> * - Translation of text into other languages changes its size. Also,
* Translation of text into other languages changes its size. Also,
* display of non-English text will use a different font in many * display of non-English text will use a different font in many
* cases. * cases.
* </para></listitem>
* </itemizedlist>
* *
* In addition, the fixed widget can't properly be mirrored in * In addition, the fixed widget can't properly be mirrored in
* right-to-left languages such as Hebrew and Arabic. i.e. normally * right-to-left languages such as Hebrew and Arabic. i.e. normally

8
gtk/gtkflowbox.c
View File

@ -3841,11 +3841,9 @@ gtk_flow_box_class_init (GtkFlowBoxClass *class)
* the variant with the Shift modifier extends the selection, * the variant with the Shift modifier extends the selection,
* the variant without the Shift modifer does not. * the variant without the Shift modifer does not.
* There are too many key combinations to list them all here. * There are too many key combinations to list them all here.
* <itemizedlist> * - Arrow keys move by individual children
* <listitem>Arrow keys move by individual children</listitem> * - Home/End keys move to the ends of the box
* <listitem>Home/End keys move to the ends of the box</listitem> * - PageUp/PageDown keys move vertically by pages
* <listitem>PageUp/PageDown keys move vertically by pages</listitem>
* </itemizedlist>
*/ */
signals[MOVE_CURSOR] = g_signal_new ("move-cursor", signals[MOVE_CURSOR] = g_signal_new ("move-cursor",
GTK_TYPE_FLOW_BOX, GTK_TYPE_FLOW_BOX,

18
gtk/gtkicontheme.c
View File

@ -80,27 +80,23 @@
* Named icons are similar to the <xref linkend="gtk3-Themeable-Stock-Images"/> * Named icons are similar to the <xref linkend="gtk3-Themeable-Stock-Images"/>
* facility, and the distinction between the two may be a bit confusing. * facility, and the distinction between the two may be a bit confusing.
* A few things to keep in mind: * A few things to keep in mind:
* <itemizedlist> *
* <listitem> * - Stock images usually are used in conjunction with
* Stock images usually are used in conjunction with
* <xref linkend="gtk3-Stock-Items"/>, such as %GTK_STOCK_OK or * <xref linkend="gtk3-Stock-Items"/>, such as %GTK_STOCK_OK or
* %GTK_STOCK_OPEN. Named icons are easier to set up and therefore * %GTK_STOCK_OPEN. Named icons are easier to set up and therefore
* are more useful for new icons that an application wants to * are more useful for new icons that an application wants to
* add, such as application icons or window icons. * add, such as application icons or window icons.
* </listitem> *
* <listitem> * - Stock images can only be loaded at the symbolic sizes defined
* Stock images can only be loaded at the symbolic sizes defined
* by the #GtkIconSize enumeration, or by custom sizes defined * by the #GtkIconSize enumeration, or by custom sizes defined
* by gtk_icon_size_register(), while named icons are more flexible * by gtk_icon_size_register(), while named icons are more flexible
* and any pixel size can be specified. * and any pixel size can be specified.
* </listitem> *
* <listitem> * - Because stock images are closely tied to stock items, and thus
* Because stock images are closely tied to stock items, and thus
* to actions in the user interface, stock images may come in * to actions in the user interface, stock images may come in
* multiple variants for different widget states or writing * multiple variants for different widget states or writing
* directions. * directions.
* </listitem> *
* </itemizedlist>
* A good rule of thumb is that if there is a stock image for what * A good rule of thumb is that if there is a stock image for what
* you want to use, use it, otherwise use a named icon. It turns * you want to use, use it, otherwise use a named icon. It turns
* out that internally stock images are generally defined in * out that internally stock images are generally defined in

9
gtk/gtkiconview.c
View File

@ -849,12 +849,9 @@ gtk_icon_view_class_init (GtkIconViewClass *klass)
* programmatically. * programmatically.
* *
* The default bindings for this signal include * The default bindings for this signal include
* <itemizedlist> * - Arrow keys which move by individual steps
* <listitem>Arrow keys which move by individual steps</listitem> * - Home/End keys which move to the first/last item
* <listitem>Home/End keys which move to the first/last item</listitem> * - PageUp/PageDown which move by "pages"
* <listitem>PageUp/PageDown which move by "pages"</listitem>
* </itemizedlist>
*
* All of these will extend the selection when combined with * All of these will extend the selection when combined with
* the Shift modifier. * the Shift modifier.
*/ */

7
gtk/gtklabel.c
View File

@ -593,10 +593,9 @@ gtk_label_class_init (GtkLabelClass *class)
* the variant with the Shift modifier extends the selection, * the variant with the Shift modifier extends the selection,
* the variant without the Shift modifer does not. * the variant without the Shift modifer does not.
* There are too many key combinations to list them all here. * There are too many key combinations to list them all here.
* <itemizedlist> * - Arrow keys move by individual characters/lines
* <listitem>Arrow keys move by individual characters/lines</listitem> * - Ctrl-arrow key combinations move by words/paragraphs
* <listitem>Ctrl-arrow key combinations move by words/paragraphs</listitem> * - Home/End keys move to the ends of the buffer
* <listitem>Home/End keys move to the ends of the buffer</listitem>
* </itemizedlist> * </itemizedlist>
*/ */
signals[MOVE_CURSOR] = signals[MOVE_CURSOR] =

44
gtk/gtkmain.c
View File

@ -1467,51 +1467,33 @@ rewrite_event_for_grabs (GdkEvent *event)
* know how exactly events are handled. So here is what this function * know how exactly events are handled. So here is what this function
* does with the event: * does with the event:
* *
* <orderedlist> * 1. Compress enter/leave notify events. If the event passed build an
* <listitem><para>
* Compress enter/leave notify events. If the event passed build an
* enter/leave pair together with the next event (peeked from GDK), both * enter/leave pair together with the next event (peeked from GDK), both
* events are thrown away. This is to avoid a backlog of (de-)highlighting * events are thrown away. This is to avoid a backlog of (de-)highlighting
* widgets crossed by the pointer. * widgets crossed by the pointer.
* </para></listitem> *
* <listitem><para> * 2. Find the widget which got the event. If the widget can't be determined
* Find the widget which got the event. If the widget can't be determined
* the event is thrown away unless it belongs to a INCR transaction. * the event is thrown away unless it belongs to a INCR transaction.
* </para></listitem> *
* <listitem><para> * 3. Then the event is pushed onto a stack so you can query the currently
* Then the event is pushed onto a stack so you can query the currently
* handled event with gtk_get_current_event(). * handled event with gtk_get_current_event().
* </para></listitem> *
* <listitem><para> * 4. The event is sent to a widget. If a grab is active all events for widgets
* The event is sent to a widget. If a grab is active all events for widgets
* that are not in the contained in the grab widget are sent to the latter * that are not in the contained in the grab widget are sent to the latter
* with a few exceptions: * with a few exceptions:
* <itemizedlist> * - Deletion and destruction events are still sent to the event widget for
* <listitem><para>
* Deletion and destruction events are still sent to the event widget for
* obvious reasons. * obvious reasons.
* </para></listitem> * - Events which directly relate to the visual representation of the event
* <listitem><para>
* Events which directly relate to the visual representation of the event
* widget. * widget.
* </para></listitem> * - Leave events are delivered to the event widget if there was an enter
* <listitem><para>
* Leave events are delivered to the event widget if there was an enter
* event delivered to it before without the paired leave event. * event delivered to it before without the paired leave event.
* </para></listitem> * - Drag events are not redirected because it is unclear what the semantics
* <listitem><para>
* Drag events are not redirected because it is unclear what the semantics
* of that would be. * of that would be.
* </para></listitem>
* </itemizedlist>
* Another point of interest might be that all key events are first passed * Another point of interest might be that all key events are first passed
* through the key snooper functions if there are any. Read the description * through the key snooper functions if there are any. Read the description
* of gtk_key_snooper_install() if you need this feature. * of gtk_key_snooper_install() if you need this feature.
* </para></listitem> *
* <listitem><para> * 5. After finishing the delivery the event is popped from the event stack.
* After finishing the delivery the event is popped from the event stack.
* </para></listitem>
* </orderedlist>
*/ */
void void
gtk_main_do_event (GdkEvent *event) gtk_main_do_event (GdkEvent *event)

8
gtk/gtkshow.c
View File

@ -37,11 +37,9 @@
* need to install gvfs to get support for uri schemes such as http:// * need to install gvfs to get support for uri schemes such as http://
* or ftp://, as only local files are handled by GIO itself). * or ftp://, as only local files are handled by GIO itself).
* Typical examples are * Typical examples are
* <simplelist> * - <filename>file:///home/gnome/pict.jpg</filename>
* <member><filename>file:///home/gnome/pict.jpg</filename></member> * - <filename>http://www.gnome.org</filename>
* <member><filename>http://www.gnome.org</filename></member> * - <filename>mailto:me&commat;gnome.org</filename>
* <member><filename>mailto:me&commat;gnome.org</filename></member>
* </simplelist>
* Ideally the timestamp is taken from the event triggering * Ideally the timestamp is taken from the event triggering
* the gtk_show_uri() call. If timestamp is not known you can take * the gtk_show_uri() call. If timestamp is not known you can take
* %GDK_CURRENT_TIME. * %GDK_CURRENT_TIME.

12
gtk/gtktextview.c
View File

@ -940,13 +940,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* the variant with the Shift modifier extends the selection, * the variant with the Shift modifier extends the selection,
* the variant without the Shift modifer does not. * the variant without the Shift modifer does not.
* There are too many key combinations to list them all here. * There are too many key combinations to list them all here.
* <itemizedlist> * - Arrow keys move by individual characters/lines
* <listitem>Arrow keys move by individual characters/lines</listitem> * - Ctrl-arrow key combinations move by words/paragraphs
* <listitem>Ctrl-arrow key combinations move by words/paragraphs</listitem> * - Home/End keys move to the ends of the buffer
* <listitem>Home/End keys move to the ends of the buffer</listitem> * - PageUp/PageDown keys move vertically by pages
* <listitem>PageUp/PageDown keys move vertically by pages</listitem> * - Ctrl-PageUp/PageDown keys move horizontally by pages
* <listitem>Ctrl-PageUp/PageDown keys move horizontally by pages</listitem>
* </itemizedlist>
*/ */
signals[MOVE_CURSOR] = signals[MOVE_CURSOR] =
g_signal_new (I_("move-cursor"), g_signal_new (I_("move-cursor"),

62
gtk/gtktoolitem.c
View File

@ -37,22 +37,7 @@
* SECTION:gtktoolitem * SECTION:gtktoolitem
* @short_description: The base class of widgets that can be added to GtkToolShell * @short_description: The base class of widgets that can be added to GtkToolShell
* @Title: GtkToolItem * @Title: GtkToolItem
* @see_also: <variablelist> * @see_also: #GtkToolbar, #GtkToolButton, #GtkSeparatorToolItem
* <varlistentry>
* <term>#GtkToolbar</term>
* <listitem><para>The toolbar widget</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>#GtkToolButton</term>
* <listitem><para>A subclass of #GtkToolItem that displays buttons on
* the toolbar</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>#GtkSeparatorToolItem</term>
* <listitem><para>A subclass of #GtkToolItem that separates groups of
* items on a toolbar</para></listitem>
* </varlistentry>
* </variablelist>
* *
* #GtkToolItem<!-- -->s are widgets that can appear on a toolbar. To * #GtkToolItem<!-- -->s are widgets that can appear on a toolbar. To
* create a toolbar item that contain something else than a button, use * create a toolbar item that contain something else than a button, use
@ -221,20 +206,17 @@ gtk_tool_item_class_init (GtkToolItemClass *klass)
* This signal is emitted when the toolbar needs information from @tool_item * This signal is emitted when the toolbar needs information from @tool_item
* about whether the item should appear in the toolbar overflow menu. In * about whether the item should appear in the toolbar overflow menu. In
* response the tool item should either * response the tool item should either
* <itemizedlist> *
* <listitem>call gtk_tool_item_set_proxy_menu_item() with a %NULL * - call gtk_tool_item_set_proxy_menu_item() with a %NULL
* pointer and return %TRUE to indicate that the item should not appear * pointer and return %TRUE to indicate that the item should not appear
* in the overflow menu * in the overflow menu
* </listitem> *
* <listitem> call gtk_tool_item_set_proxy_menu_item() with a new menu * - call gtk_tool_item_set_proxy_menu_item() with a new menu
* item and return %TRUE, or * item and return %TRUE, or
* </listitem> *
* <listitem> return %FALSE to indicate that the signal was not * - return %FALSE to indicate that the signal was not handled by the item.
* handled by the item. This means that * This means that the item will not appear in the overflow menu unless
* the item will not appear in the overflow menu unless a later handler * a later handler installs a menu item.
* installs a menu item.
* </listitem>
* </itemizedlist>
* *
* The toolbar may cache the result of this signal. When the tool item changes * The toolbar may cache the result of this signal. When the tool item changes
* how it will respond to this signal it must call gtk_tool_item_rebuild_menu() * how it will respond to this signal it must call gtk_tool_item_rebuild_menu()
@ -259,12 +241,10 @@ gtk_tool_item_class_init (GtkToolItemClass *klass)
* This signal is emitted when some property of the toolbar that the * This signal is emitted when some property of the toolbar that the
* item is a child of changes. For custom subclasses of #GtkToolItem, * item is a child of changes. For custom subclasses of #GtkToolItem,
* the default handler of this signal use the functions * the default handler of this signal use the functions
* <itemizedlist> * - gtk_tool_shell_get_orientation()
* <listitem>gtk_tool_shell_get_orientation()</listitem> * - gtk_tool_shell_get_style()
* <listitem>gtk_tool_shell_get_style()</listitem> * - gtk_tool_shell_get_icon_size()
* <listitem>gtk_tool_shell_get_icon_size()</listitem> * - gtk_tool_shell_get_relief_style()
* <listitem>gtk_tool_shell_get_relief_style()</listitem>
* </itemizedlist>
* to find out what the toolbar should look like and change * to find out what the toolbar should look like and change
* themselves accordingly. * themselves accordingly.
**/ **/
@ -796,16 +776,12 @@ gtk_tool_item_get_orientation (GtkToolItem *tool_item)
* the toolbar is displayed and change themselves accordingly * the toolbar is displayed and change themselves accordingly
* *
* Possibilities are: * Possibilities are:
* <itemizedlist> * - %GTK_TOOLBAR_BOTH, meaning the tool item should show
* <listitem> GTK_TOOLBAR_BOTH, meaning the tool item should show * both an icon and a label, stacked vertically
* both an icon and a label, stacked vertically </listitem> * - %GTK_TOOLBAR_ICONS, meaning the toolbar shows only icons
* <listitem> GTK_TOOLBAR_ICONS, meaning the toolbar shows * - %GTK_TOOLBAR_TEXT, meaning the tool item should only show text
* only icons </listitem> * - %GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show
* <listitem> GTK_TOOLBAR_TEXT, meaning the tool item should only * both an icon and a label, arranged horizontally
* show text</listitem>
* <listitem> GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show
* both an icon and a label, arranged horizontally</listitem>
* </itemizedlist>
* *
* Return value: A #GtkToolbarStyle indicating the toolbar style used * Return value: A #GtkToolbarStyle indicating the toolbar style used
* for @tool_item. * for @tool_item.

42
gtk/gtktooltip.c
View File

@ -52,58 +52,34 @@
* When you need a tooltip with a little more fancy contents, like adding an * When you need a tooltip with a little more fancy contents, like adding an
* image, or you want the tooltip to have different contents per #GtkTreeView * image, or you want the tooltip to have different contents per #GtkTreeView
* row or cell, you will have to do a little more work: * row or cell, you will have to do a little more work:
* <itemizedlist> *
* <listitem> * - Set the #GtkWidget:has-tooltip property to %TRUE, this will make GTK+
* <para>
* Set the #GtkWidget:has-tooltip property to %TRUE, this will make GTK+
* monitor the widget for motion and related events which are needed to * monitor the widget for motion and related events which are needed to
* determine when and where to show a tooltip. * determine when and where to show a tooltip.
* </para> *
* </listitem> * - Connect to the #GtkWidget::query-tooltip signal. This signal will be
* <listitem>
* <para>
* Connect to the #GtkWidget::query-tooltip signal. This signal will be
* emitted when a tooltip is supposed to be shown. One of the arguments passed * emitted when a tooltip is supposed to be shown. One of the arguments passed
* to the signal handler is a GtkTooltip object. This is the object that we * to the signal handler is a GtkTooltip object. This is the object that we
* are about to display as a tooltip, and can be manipulated in your callback * are about to display as a tooltip, and can be manipulated in your callback
* using functions like gtk_tooltip_set_icon(). There are functions for setting * using functions like gtk_tooltip_set_icon(). There are functions for setting
* the tooltip's markup, setting an image from a named icon, or even putting in * the tooltip's markup, setting an image from a named icon, or even putting in
* a custom widget. * a custom widget.
* </para> *
* </listitem>
* <listitem>
* <para>
* Return %TRUE from your query-tooltip handler. This causes the tooltip to be * Return %TRUE from your query-tooltip handler. This causes the tooltip to be
* show. If you return %FALSE, it will not be shown. * show. If you return %FALSE, it will not be shown.
* </para>
* </listitem>
* </itemizedlist>
* *
* In the probably rare case where you want to have even more control over the * In the probably rare case where you want to have even more control over the
* tooltip that is about to be shown, you can set your own #GtkWindow which * tooltip that is about to be shown, you can set your own #GtkWindow which
* will be used as tooltip window. This works as follows: * will be used as tooltip window. This works as follows:
* <itemizedlist> *
* <listitem> * - Set #GtkWidget:has-tooltip and connect to #GtkWidget::query-tooltip as before.
* <para>
* Set #GtkWidget:has-tooltip and connect to #GtkWidget::query-tooltip as
* before.
* </para>
* </listitem>
* <listitem>
* <para>
* Use gtk_widget_set_tooltip_window() to set a #GtkWindow created by you as * Use gtk_widget_set_tooltip_window() to set a #GtkWindow created by you as
* tooltip window. * tooltip window.
* </para> *
* </listitem> * - In the #GtkWidget::query-tooltip callback you can access your window using
* <listitem>
* <para>
* In the #GtkWidget::query-tooltip callback you can access your window using
* gtk_widget_get_tooltip_window() and manipulate as you wish. The semantics of * gtk_widget_get_tooltip_window() and manipulate as you wish. The semantics of
* the return value are exactly as before, return %TRUE to show the window, * the return value are exactly as before, return %TRUE to show the window,
* %FALSE to not show it. * %FALSE to not show it.
* </para>
* </listitem>
* </itemizedlist>
*/ */

29
gtk/gtktreemodel.c
View File

@ -209,21 +209,20 @@
* *
* When working with reference counting, the following rules must be taken * When working with reference counting, the following rules must be taken
* into account: * into account:
* <itemizedlist> *
* <listitem><para>Never take a reference on a node without owning a * - Never take a reference on a node without owning a reference on its parent.
* reference on its parent. This means that all parent nodes of a referenced * This means that all parent nodes of a referenced node must be referenced
* node must be referenced as well.</para></listitem> * as well.
* <listitem><para>Outstanding references on a deleted node are not released. *
* This is not possible because the node has already been deleted by the * - Outstanding references on a deleted node are not released. This is not
* time the row-deleted signal is received. * possible because the node has already been deleted by the time the
* </para></listitem> * row-deleted signal is received.
* <listitem><para>Models are not obligated to emit a signal on rows of *
* which none of its siblings are referenced. To phrase this differently, * - Models are not obligated to emit a signal on rows of which none of its
* signals are only required for levels in which nodes are referenced. For * siblings are referenced. To phrase this differently, signals are only
* the root level however, signals must be emitted at all times (however the * required for levels in which nodes are referenced. For the root level
* root level is always referenced when any view is attached). * however, signals must be emitted at all times (however the root level
* </para></listitem> * is always referenced when any view is attached).
* </itemizedlist>
*/ */
#define INITIALIZE_TREE_ITER(Iter) \ #define INITIALIZE_TREE_ITER(Iter) \

26
gtk/gtktreemodelfilter.c
View File

@ -32,25 +32,21 @@
* *
* A #GtkTreeModelFilter is a tree model which wraps another tree model, * A #GtkTreeModelFilter is a tree model which wraps another tree model,
* and can do the following things: * and can do the following things:
* <itemizedlist> *
* <listitem><para> * - Filter specific rows, based on data from a "visible column", a column
* Filter specific rows, based on data from a "visible column", a column
* storing booleans indicating whether the row should be filtered or not, * storing booleans indicating whether the row should be filtered or not,
* or based on the return value of a "visible function", which gets a * or based on the return value of a "visible function", which gets a
* model, iter and user_data and returns a boolean indicating whether the * model, iter and user_data and returns a boolean indicating whether the
* row should be filtered or not. * row should be filtered or not.
* </para></listitem> *
* <listitem><para> * - Modify the "appearance" of the model, using a modify function.
* Modify the "appearance" of the model, using a modify function. * This is extremely powerful and allows for just changing some
* This is extremely powerful and allows for just changing * values and also for creating a completely different model based
* some values and also for creating a completely different model based on * on the given child model.
* the given child model. *
* </para></listitem> * - Set a different root node, also known as a "virtual root". You can pass
* <listitem><para> * in a #GtkTreePath indicating the root node for the filter at construction
* Set a different root node, also known as a "virtual root". You can pass in * time.
* a #GtkTreePath indicating the root node for the filter at construction time.
* </para></listitem>
* </itemizedlist>
* *
* The basic API is similar to #GtkTreeModelSort. For an example on its usage, * The basic API is similar to #GtkTreeModelSort. For an example on its usage,
* see the section on #GtkTreeModelSort. * see the section on #GtkTreeModelSort.

15
gtk/gtktreesortable.c
View File

@ -147,16 +147,11 @@ gtk_tree_sortable_get_sort_column_id (GtkTreeSortable *sortable,
* resort itself to reflect this change, after emitting a * resort itself to reflect this change, after emitting a
* #GtkTreeSortable::sort-column-changed signal. @sort_column_id may either be * #GtkTreeSortable::sort-column-changed signal. @sort_column_id may either be
* a regular column id, or one of the following special values: * a regular column id, or one of the following special values:
* <variablelist> *
* <varlistentry> * - %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID: the default sort function
* <term>%GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID</term> * will be used, if it is set
* <listitem>the default sort function will be used, if it is set</listitem> *
* </varlistentry> * - %GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID: no sorting will occur
* <varlistentry>
* <term>%GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID</term>
* <listitem>no sorting will occur</listitem>
* </varlistentry>
* </variablelist>
*/ */
void void
gtk_tree_sortable_set_sort_column_id (GtkTreeSortable *sortable, gtk_tree_sortable_set_sort_column_id (GtkTreeSortable *sortable,