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

Documentation fixes.

Browse Source 
Sun Oct 13 18:50:14 2002  Soeren Sandmann  <sandmann@daimi.au.dk>

	* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
	gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
	gtktreemodel.sgml,gtktable.sgml, gtktable.c:

	Documentation fixes.

	#85719, #90759, #95169, Owen Taylor;
	#89221, Yao Zhang, Matthias Clasen;
	#95592, Joost Faassen;
	#92637, Vitaly Tishkov;
	#94616, Ben Martin;
	#94772, sbaillie@bigpond.net.au;
This commit is contained in:
Soeren Sandmann 2002-10-13 17:17:14 +00:00 committed by Søren Sandmann Pedersen
parent 7fe315b58d
commit a130f089ca
46 changed files with 925 additions and 230 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
ChangeLog
View File

@ -1,4 +1,19 @@
Sun Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtk/gtkwidget.c (gtk_widget_queue_clear_area): Don't invalidate
a widget if it or one of its ancestors isn't mapped.

17
ChangeLog.pre-2-10
View File

@ -1,4 +1,19 @@
Sun Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtk/gtkwidget.c (gtk_widget_queue_clear_area): Don't invalidate
a widget if it or one of its ancestors isn't mapped.

17
ChangeLog.pre-2-2
View File

@ -1,4 +1,19 @@
Sun Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtk/gtkwidget.c (gtk_widget_queue_clear_area): Don't invalidate
a widget if it or one of its ancestors isn't mapped.

17
ChangeLog.pre-2-4
View File

@ -1,4 +1,19 @@
Sun Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtk/gtkwidget.c (gtk_widget_queue_clear_area): Don't invalidate
a widget if it or one of its ancestors isn't mapped.

17
ChangeLog.pre-2-6
View File

@ -1,4 +1,19 @@
Sun Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtk/gtkwidget.c (gtk_widget_queue_clear_area): Don't invalidate
a widget if it or one of its ancestors isn't mapped.

17
ChangeLog.pre-2-8
View File

@ -1,4 +1,19 @@
Sun Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
Oct 13 17:41:53 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtk/gtkwidget.c (gtk_widget_queue_clear_area): Don't invalidate
a widget if it or one of its ancestors isn't mapped.

9
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
View File

@ -87,6 +87,15 @@ Application-driven progressive image loading.
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_loader_get_format ##### -->
<para>
</para>
@loader:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_loader_write ##### -->
<para>

148
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
View File

@ -365,21 +365,6 @@ XlibRGB
@obj: A GTK+ object.
<!-- ##### STRUCT GdkPixbufFormat ##### -->
<para>
A #GdkPixbufFormat contains information about the image format accepted by a
module. Only modules should access the fields directly.
</para>
@name: the name of the image format
@signature: the signature of the module
@domain: the message domain for the @description
@description: a description of the image format
@mime_types: a %NULL-terminated array of MIME types for the image format.
@extensions: a %NULL-terminated array of typical filename extensions for the
image format.
@flags:
<!-- ##### STRUCT GdkPixbufFrame ##### -->
<para>
This object describes an individual frame of an animation.
@ -412,92 +397,6 @@ image format.
@pixbuf: The pixbuf that is losing its last reference.
@data: User closure data.
<!-- ##### USER_FUNCTION GdkPixbufModuleFillInfoFunc ##### -->
<para>
Defines the type of the function used to fill a
#GdkPixbufFormat structure with information about a module.
</para>
@info: a #GdkPixbufFormat.
<!-- ##### USER_FUNCTION GdkPixbufModuleFillVtableFunc ##### -->
<para>
Defines the type of the function used to set the vtable of a
#GdkPixbufModule when it is loaded.
</para>
@module: a #GdkPixbufModule.
<!-- ##### STRUCT GdkPixbufModulePattern ##### -->
<para>
The signature of a module is a set of prefixes. Prefixes are encoded as
pairs of ordinary strings, where the second string, if not %NULL,
may contain ' ', '!', 'x', 'z', and 'n' to indicate bytes that must be
matched, not matched, "don't-care"-bytes, zeros and non-zeros.
Each prefix has an associated integer that describes the relevance of
the prefix, with 0 meaning a mismatch and 100 a "perfect match".
</para>
<para>
The signature of a module is stored as an array of
#GdkPixbufModulePattern<!-- -->s.
</para>
@prefix: the prefix for this pattern
@mask: mask containing bytes which modify how the prefix is matched against
test data
@relevance: relevance of this pattern
<!-- ##### USER_FUNCTION GdkPixbufModulePreparedFunc ##### -->
<para>
Defines the type of the function that gets called once the initial
setup of @pixbuf is done.
</para>
<para>
#GdkPixbufLoader uses a function of this type to emit the
"<link linkend="GdkPixbufLoader-area-prepared">area_prepared</link>"
signal.
</para>
@pixbuf: the #GdkPixbuf that is currently being loaded.
@anim: if an animation is being loaded, the #GdkPixbufAnimation, else %NULL.
@user_data: the loader.
<!-- ##### USER_FUNCTION GdkPixbufModuleSizeFunc ##### -->
<para>
Defines the type of the function that gets called once the size
of the loaded image is known.
</para>
<para>
The function is expected to set @width and @height to the desired
size to which the image should be scaled. If a module has no efficient
way to achieve the desired scaling during the loading of the image, it may
either ignore the size request, or only approximate it -- &gdk-pixbuf; will
then perform the required scaling on the completely loaded image.
</para>
@width: pointer to a location containing the current image width
@height: pointer to a location containing the current image height
@user_data: the loader.
<!-- ##### USER_FUNCTION GdkPixbufModuleUpdatedFunc ##### -->
<para>
Defines the type of the function that gets called every time a region
of @pixbuf is updated.
</para>
<para>
#GdkPixbufLoader uses a function of this type to emit the
"<link linkend="GdkPixbufLoader-area-updated">area_updated</link>"
signal.
</para>
@pixbuf: the #GdkPixbuf that is currently being loaded.
@x: the X origin of the updated area.
@y: the Y origin of the updated area.
@width: the width of the updated area.
@height: the height of the updated area.
@user_data: the loader.
<!-- ##### ARG GnomeCanvasPixbuf:height ##### -->
<para>
Indicates the height the pixbuf will be scaled to. This argument
@ -668,53 +567,6 @@ End:
</para>
<!-- ##### FUNCTION gdk_pixbuf_format_get_description ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_extensions ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_mime_types ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_name ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_is_writable ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_get_formats ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_new_from_stream ##### -->
<para>

189
docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
View File

@ -65,6 +65,183 @@ They are not covered by the same stability guarantees as the regular
</para>
<!-- ##### FUNCTION gdk_pixbuf_set_option ##### -->
<para>
</para>
@pixbuf:
@key:
@value:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_get_formats ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_name ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_description ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_mime_types ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_get_extensions ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_format_is_writable ##### -->
<para>
</para>
@format:
@Returns:
<!-- ##### STRUCT GdkPixbufFormat ##### -->
<para>
A #GdkPixbufFormat contains information about the image format accepted by a
module. Only modules should access the fields directly.
</para>
@name: the name of the image format
@signature: the signature of the module
@domain: the message domain for the @description
@description: a description of the image format
@mime_types: a %NULL-terminated array of MIME types for the image format.
@extensions: a %NULL-terminated array of typical filename extensions for the
image format.
@flags:
<!-- ##### ENUM GdkPixbufFormatFlags ##### -->
<para>
</para>
@GDK_PIXBUF_FORMAT_WRITABLE:
<!-- ##### STRUCT GdkPixbufModulePattern ##### -->
<para>
The signature of a module is a set of prefixes. Prefixes are encoded as
pairs of ordinary strings, where the second string, if not %NULL,
may contain ' ', '!', 'x', 'z', and 'n' to indicate bytes that must be
matched, not matched, "don't-care"-bytes, zeros and non-zeros.
Each prefix has an associated integer that describes the relevance of
the prefix, with 0 meaning a mismatch and 100 a "perfect match".
</para>
<para>
The signature of a module is stored as an array of
#GdkPixbufModulePattern<!-- -->s.
</para>
@prefix: the prefix for this pattern
@mask: mask containing bytes which modify how the prefix is matched against
test data
@relevance: relevance of this pattern
<!-- ##### USER_FUNCTION GdkPixbufModuleFillVtableFunc ##### -->
<para>
Defines the type of the function used to set the vtable of a
#GdkPixbufModule when it is loaded.
</para>
@module: a #GdkPixbufModule.
<!-- ##### USER_FUNCTION GdkPixbufModuleFillInfoFunc ##### -->
<para>
Defines the type of the function used to fill a
#GdkPixbufFormat structure with information about a module.
</para>
@info: a #GdkPixbufFormat.
<!-- ##### USER_FUNCTION GdkPixbufModuleSizeFunc ##### -->
<para>
Defines the type of the function that gets called once the size
of the loaded image is known.
</para>
<para>
The function is expected to set @width and @height to the desired
size to which the image should be scaled. If a module has no efficient
way to achieve the desired scaling during the loading of the image, it may
either ignore the size request, or only approximate it -- &gdk-pixbuf; will
then perform the required scaling on the completely loaded image.
</para>
@width: pointer to a location containing the current image width
@height: pointer to a location containing the current image height
@user_data: the loader.
<!-- ##### USER_FUNCTION GdkPixbufModulePreparedFunc ##### -->
<para>
Defines the type of the function that gets called once the initial
setup of @pixbuf is done.
</para>
<para>
#GdkPixbufLoader uses a function of this type to emit the
"<link linkend="GdkPixbufLoader-area-prepared">area_prepared</link>"
signal.
</para>
@pixbuf: the #GdkPixbuf that is currently being loaded.
@anim: if an animation is being loaded, the #GdkPixbufAnimation, else %NULL.
@user_data: the loader.
<!-- ##### USER_FUNCTION GdkPixbufModuleUpdatedFunc ##### -->
<para>
Defines the type of the function that gets called every time a region
of @pixbuf is updated.
</para>
<para>
#GdkPixbufLoader uses a function of this type to emit the
"<link linkend="GdkPixbufLoader-area-updated">area_updated</link>"
signal.
</para>
@pixbuf: the #GdkPixbuf that is currently being loaded.
@x: the X origin of the updated area.
@y: the Y origin of the updated area.
@width: the width of the updated area.
@height: the height of the updated area.
@user_data: the loader.
<!-- ##### STRUCT GdkPixbufModule ##### -->
<para>
A #GdkPixbufModule contains the necessary functions to load and save
@ -96,3 +273,15 @@ is loaded and must set the function pointers of the #GdkPixbufModule.
@_reserved5:
@_reserved6:
<!-- ##### STRUCT GdkPixbufAnimationClass ##### -->
<para>
</para>
<!-- ##### STRUCT GdkPixbufAnimationIterClass ##### -->
<para>
</para>

14
docs/reference/gdk/tmpl/dnd.sgml
View File

@ -96,6 +96,20 @@ This function is called by the drag source to obtain the
@protocol: location to store the DND protocol in.
<!-- ##### FUNCTION gdk_drag_find_window_for_screen ##### -->
<para>
</para>
@context:
@drag_window:
@screen:
@x_root:
@y_root:
@dest_window:
@protocol:
<!-- ##### FUNCTION gdk_drag_context_ref ##### -->
<para>
Deprecated function; use g_object_ref() instead.

19
docs/reference/gdk/tmpl/drawing.sgml
View File

@ -204,6 +204,25 @@ lines.
@npoints: the size of the @points array.
<!-- ##### FUNCTION gdk_draw_pixbuf ##### -->
<para>
</para>
@drawable:
@gc:
@pixbuf:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@dither:
@x_dither:
@y_dither:
<!-- ##### FUNCTION gdk_draw_segments ##### -->
<para>
Draws a number of unconnected lines.

27
docs/reference/gdk/tmpl/events.sgml
View File

@ -183,6 +183,15 @@ is given in the <link linkend="glib-The-Main-Event-Loop">GLib Main Loop</link>.
@event:
<!-- ##### FUNCTION gdk_event_new ##### -->
<para>
</para>
@type:
@Returns:
<!-- ##### FUNCTION gdk_event_copy ##### -->
<para>
</para>
@ -323,6 +332,24 @@ gdk_event_handler_set().
@show_events:
<!-- ##### FUNCTION gdk_event_set_screen ##### -->
<para>
</para>
@event:
@screen:
<!-- ##### FUNCTION gdk_event_get_screen ##### -->
<para>
</para>
@event:
@Returns:
<!-- ##### FUNCTION gdk_setting_get ##### -->
<para>
</para>

10
docs/reference/gdk/tmpl/gdk-unused.sgml
View File

@ -914,6 +914,16 @@ they will be ignored.
@screen:
<!-- ##### FUNCTION gdk_screen_get_window_at_pointer ##### -->
<para>
</para>
@screen:
@win_x:
@win_y:
@Returns:
<!-- ##### FUNCTION gdk_screen_use_virtual_screen ##### -->
<para>

42
docs/reference/gdk/tmpl/gdkdisplay.sgml
View File

@ -196,6 +196,48 @@ of an X display. All its fields are private and should not be accessed directly.
@msec:
<!-- ##### FUNCTION gdk_display_get_pointer ##### -->
<para>
</para>
@display:
@screen:
@x:
@y:
@mask:
<!-- ##### FUNCTION gdk_display_get_window_at_pointer ##### -->
<para>
</para>
@display:
@win_x:
@win_y:
@Returns:
<!-- ##### STRUCT GdkDisplayPointerHooks ##### -->
<para>
</para>
@get_pointer:
@window_get_pointer:
@window_at_pointer:
<!-- ##### FUNCTION gdk_display_set_pointer_hooks ##### -->
<para>
</para>
@display:
@new_hooks:
@Returns:
<!-- ##### SIGNAL GdkDisplay::closed ##### -->
<para>

20
docs/reference/gdk/tmpl/gdkscreen.sgml
View File

@ -119,17 +119,6 @@ when GDK gets multihead support.
@Returns:
<!-- ##### FUNCTION gdk_screen_get_window_at_pointer ##### -->
<para>
</para>
@screen:
@win_x:
@win_y:
@Returns:
<!-- ##### FUNCTION gdk_screen_get_width ##### -->
<para>
@ -184,6 +173,15 @@ when GDK gets multihead support.
@Returns:
<!-- ##### FUNCTION gdk_screen_make_display_name ##### -->
<para>
</para>
@screen:
@Returns:
<!-- ##### FUNCTION gdk_screen_get_n_monitors ##### -->
<para>

34
docs/reference/gdk/tmpl/windows.sgml
View File

@ -401,6 +401,22 @@ Deprecated equivalent of g_object_unref()
@window:
<!-- ##### FUNCTION gdk_window_fullscreen ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gdk_window_unfullscreen ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gdk_window_move ##### -->
<para>
@ -932,6 +948,24 @@ Deprecated equivalent to gdk_drawable_set_colormap()
@hint:
<!-- ##### FUNCTION gdk_window_set_skip_taskbar_hint ##### -->
<para>
</para>
@window:
@skips_taskbar:
<!-- ##### FUNCTION gdk_window_set_skip_pager_hint ##### -->
<para>
</para>
@window:
@skips_pager:
<!-- ##### FUNCTION gdk_window_get_position ##### -->
<para>

45
docs/reference/gdk/tmpl/x_interaction.sgml
View File

@ -417,6 +417,35 @@ Obtains the #GdkFont for the given Xlib font ID on @display, or %NULL if no
@Returns:
<!-- ##### FUNCTION gdk_x11_screen_get_window_manager_name ##### -->
<para>
</para>
@screen:
@Returns:
<!-- ##### FUNCTION gdk_x11_screen_lookup_visual ##### -->
<para>
</para>
@screen:
@xvisualid:
@Returns:
<!-- ##### FUNCTION gdk_x11_colormap_foreign_new ##### -->
<para>
</para>
@visual:
@xcolormap:
@Returns:
<!-- ##### FUNCTION gdk_x11_colormap_get_xcolormap ##### -->
<para>
Returns the X colormap belonging to a #GdkColormap.
@ -464,6 +493,22 @@ Returns the display of a #GdkCursor.
@Returns:
<!-- ##### FUNCTION gdk_x11_display_grab ##### -->
<para>
</para>
@display:
<!-- ##### FUNCTION gdk_x11_display_ungrab ##### -->
<para>
</para>
@display:
<!-- ##### FUNCTION gdk_x11_drawable_get_xdisplay ##### -->
<para>
Returns the display of a #GdkDrawable.

24
docs/reference/gtk/tmpl/gtk-unused.sgml
View File

@ -1122,6 +1122,30 @@ and its unique identifying integer.
@nparams:
@params:
<!-- ##### SIGNAL GtkStatusbar::text-popped ##### -->
<para>
Is emitted whenever a new message is popped off a statusbar's stack.
</para>
@statusbar: the object which received the signal.
@context_id: the context id of the relevant message/statusbar.
@text: the message that was just popped.
<!-- ##### SIGNAL GtkStatusbar::text-pushed ##### -->
<para>
Is emitted whenever a new message gets pushed onto a statusbar's stack.
</para>
@statusbar: the object which received the signal.
@context_id: the context id of the relevant message/statusbar.
@text: the message that was pushed.
<!-- ##### ARG GtkStatusbar:shadow-type ##### -->
<para>
</para>
<!-- ##### STRUCT GtkStatusbarMsg ##### -->
<para>
Holds the data for a statusbar message. <structfield>text</structfield> holds the actual text string. <structfield>context_id</structfield> is the context that this message is associated with, and <structfield>message_id</structfield> is this particular message's identifier. However, these fields should not be modified directly.

11
docs/reference/gtk/tmpl/gtkaccelgroup.sgml
View File

@ -98,6 +98,17 @@ Deprecated equivalent of g_object_unref().
@Returns:
<!-- ##### USER_FUNCTION GtkAccelGroupFindFunc ##### -->
<para>
</para>
@key:
@closure:
@data:
@Returns:
<!-- ##### FUNCTION gtk_accel_group_disconnect ##### -->
<para>

3
docs/reference/gtk/tmpl/gtkbox.sgml
View File

@ -131,6 +131,9 @@ field.</entry>
</tbody></tgroup></informaltable>
</para>
@children:
@spacing:
@homogeneous:
<!-- ##### STRUCT GtkBoxChild ##### -->
<para>

3
docs/reference/gtk/tmpl/gtkbutton.sgml
View File

@ -29,7 +29,8 @@ This should not be accessed directly. Use the accessor functions below.
<!-- ##### FUNCTION gtk_button_new ##### -->
<para>
Creates a new #GtkButton widget.
Creates a new #GtkButton widget. To add a child widget to the button,
use gtk_container_add().
</para>
@Returns: The newly created #GtkButton widget.

2
docs/reference/gtk/tmpl/gtkdialog.sgml
View File

@ -130,8 +130,8 @@ response from the user.</para></listitem>
<structfield>vbox</structfield> is a #GtkVBox - the main part of the
dialog box.
</para>
<para>
<para>
<structfield>action_area</structfield> is a #GtkHButtonBox packed below the
dividing #GtkHSeparator in the dialog. It is treated exactly the same
as any other #GtkHButtonBox.

12
docs/reference/gtk/tmpl/gtkiconfactory.sgml
View File

@ -221,6 +221,18 @@ looking up the icon to use for a given stock ID.
@alias:
<!-- ##### FUNCTION gtk_icon_size_lookup_for_settings ##### -->
<para>
</para>
@settings:
@size:
@width:
@height:
@Returns:
<!-- ##### FUNCTION gtk_icon_size_register ##### -->
<para>

39
docs/reference/gtk/tmpl/gtkliststore.sgml
View File

@ -167,3 +167,42 @@ drop</link> interfaces.
@list_store:
<!-- ##### FUNCTION gtk_list_store_iter_is_valid ##### -->
<para>
</para>
@list_store:
@iter:
@Returns:
<!-- ##### FUNCTION gtk_list_store_reorder ##### -->
<para>
</para>
@store:
@new_order:
<!-- ##### FUNCTION gtk_list_store_swap ##### -->
<para>
</para>
@store:
@a:
@b:
<!-- ##### FUNCTION gtk_list_store_move ##### -->
<para>
</para>
@store:
@iter:
@position:

8
docs/reference/gtk/tmpl/gtkmain.sgml
View File

@ -289,6 +289,14 @@ cleaned from any arguments that GTK+ handles itself.
@argv: Points to the argument vector.
<!-- ##### USER_FUNCTION GtkModuleDisplayInitFunc ##### -->
<para>
</para>
@display:
<!-- ##### FUNCTION gtk_true ##### -->
<para>
All this function does it to return %TRUE. This can be useful for example

22
docs/reference/gtk/tmpl/gtkmenu.sgml
View File

@ -151,21 +151,15 @@ Moves a #GtkMenuItem to a new position within the #GtkMenu.
<!-- ##### FUNCTION gtk_menu_popup ##### -->
<para>
Displays a menu and makes it available for selection. Applications can use
this function to display context-sensitive menus, and will typically supply
%NULL for the @parent_menu_shell, @parent_menu_item, @func and @data
parameters. The default menu positioning function will position the menu
at the current pointer position.
</para>
@menu: a #GtkMenu.
@parent_menu_shell: the menu shell containing the triggering menu item.
@parent_menu_item: the menu item whose activation triggered the popup.
@func: a user supplied function used to position the menu.
@data: user supplied data to be passed to @func.
@button: the button which was pressed to initiate the event.
@activate_time: the time at which the activation event occurred.
@menu:
@parent_menu_shell:
@parent_menu_item:
@func:
@data:
@button:
@activate_time:
<!-- ##### FUNCTION gtk_menu_set_accel_group ##### -->

9
docs/reference/gtk/tmpl/gtkmenushell.sgml
View File

@ -89,6 +89,15 @@ Selects the menu item from the menu shell.
@menu_item: The #GtkMenuItem to select.
<!-- ##### FUNCTION gtk_menu_shell_select_first ##### -->
<para>
</para>
@menu_shell:
@search_sensitive:
<!-- ##### FUNCTION gtk_menu_shell_deselect ##### -->
<para>
Deselects the currently selected item from the menu shell, if any.

9
docs/reference/gtk/tmpl/gtknotebook.sgml
View File

@ -244,6 +244,15 @@ gtk_notebook_set_current_page() instead.
@Returns:
<!-- ##### FUNCTION gtk_notebook_get_n_pages ##### -->
<para>
</para>
@notebook:
@Returns:
<!-- ##### FUNCTION gtk_notebook_get_tab_label ##### -->
<para>
</para>

4
docs/reference/gtk/tmpl/gtkpaned.sgml
View File

@ -58,8 +58,8 @@ gtk_widget_set_size_request (hpaned, 200 + GTK_PANED (hpaned)->gutter_size, -1);
gtk_paned_pack1 (GTK_PANED (hpaned), frame1, TRUE, FALSE);
gtk_widget_set_size_request (frame1, 50, -1);
gtk_paned_pack2 (GTK_PANED (hpaned), frame1, FALSE, FALSE);
gtk_widget_set_size_request (frame1, 50, -1);
gtk_paned_pack2 (GTK_PANED (hpaned), frame2, FALSE, FALSE);
gtk_widget_set_size_request (frame2, 50, -1);
</programlisting>
</example>

32
docs/reference/gtk/tmpl/gtkstatusbar.sgml
View File

@ -51,6 +51,15 @@ The message at the top of the stack can be removed using gtk_statusbar_pop(). A
Contains private data that should be modified with the functions described below.
</para>
@parent_widget:
@frame:
@label:
@messages:
@keys:
@seq_context_id:
@seq_message_id:
@grip_window:
@has_resize_grip:
<!-- ##### FUNCTION gtk_statusbar_new ##### -->
<para>
@ -120,26 +129,3 @@ Returns whether the statusbar has a resize grip.
@Returns: %TRUE if the statusbar has a resize grip.
<!-- ##### SIGNAL GtkStatusbar::text-popped ##### -->
<para>
Is emitted whenever a new message is popped off a statusbar's stack.
</para>
@statusbar: the object which received the signal.
@context_id: the context id of the relevant message/statusbar.
@text: the message that was just popped.
<!-- ##### SIGNAL GtkStatusbar::text-pushed ##### -->
<para>
Is emitted whenever a new message gets pushed onto a statusbar's stack.
</para>
@statusbar: the object which received the signal.
@context_id: the context id of the relevant message/statusbar.
@text: the message that was pushed.
<!-- ##### ARG GtkStatusbar:shadow-type ##### -->
<para>
</para>

7
docs/reference/gtk/tmpl/gtkstock.sgml
View File

@ -151,6 +151,13 @@ The "Close" item.
<!-- ##### MACRO GTK_STOCK_COLOR_PICKER ##### -->
<para>
</para>
<!-- ##### MACRO GTK_STOCK_CONVERT ##### -->
<para>
The "Convert" item.

4
docs/reference/gtk/tmpl/gtktable.sgml
View File

@ -135,8 +135,8 @@ and row numbers of the table. (Columns and rows are indexed from zero).
@child: The widget to add.
@left_attach: the column number to attach the left side of a child widget to.
@right_attach: the column number to attach the right side of a child widget to.
@top_attach: the row number to attach the left side of a child widget to.
@bottom_attach: the column number to attach the right side of a child widget to.
@top_attach: the row number to attach the top of a child widget to.
@bottom_attach: the column number to attach the bottom of a child widget to.
@xoptions: Used to specify the properties of the child widget when the table is resized.
@yoptions: The same as xoptions, except this field determines behaviour of vertical resizing.
@xpadding: An integer value specifying the padding on the left and right of the widget being added to the table.

31
docs/reference/gtk/tmpl/gtktreemodel.sgml
View File

@ -125,7 +125,7 @@ the second is much more common, as you often get paths from callbacks.
parent_iter = iter;
gtk_tree_model_get_nth_child (model, &amp;iter, &amp;parent_iter, 2);
parent_iter = iter;
gtk_tree_model_get_nth_child (model, &amp;iter, NULL, 5);
gtk_tree_model_get_nth_child (model, &amp;iter, &amp;parent_iter, 5);
}
</programlisting>
</example>
@ -291,6 +291,16 @@ section.
@Returns:
<!-- ##### FUNCTION gtk_tree_path_new_from_indices ##### -->
<para>
</para>
@first_index:
@Varargs:
@Returns:
<!-- ##### FUNCTION gtk_tree_path_to_string ##### -->
<para>
@ -482,6 +492,15 @@ versions of GTK+.
@reference:
<!-- ##### FUNCTION gtk_tree_row_reference_copy ##### -->
<para>
</para>
@reference:
@Returns:
<!-- ##### FUNCTION gtk_tree_row_reference_inserted ##### -->
<para>
@ -685,6 +704,16 @@ versions of GTK+.
@Returns:
<!-- ##### FUNCTION gtk_tree_model_get_string_from_iter ##### -->
<para>
</para>
@tree_model:
@iter:
@Returns:
<!-- ##### FUNCTION gtk_tree_model_ref_node ##### -->
<para>

10
docs/reference/gtk/tmpl/gtktreemodelsort.sgml
View File

@ -98,6 +98,16 @@ GtkTreeModelSort
@tree_model_sort:
<!-- ##### FUNCTION gtk_tree_model_sort_iter_is_valid ##### -->
<para>
</para>
@tree_model_sort:
@iter:
@Returns:
<!-- ##### ARG GtkTreeModelSort:model ##### -->
<para>

29
docs/reference/gtk/tmpl/gtktreeselection.sgml
View File

@ -142,6 +142,25 @@ selected rows. It will be called on every selected row in the view.
@data:
<!-- ##### FUNCTION gtk_tree_selection_get_selected_rows ##### -->
<para>
</para>
@selection:
@model:
@Returns:
<!-- ##### FUNCTION gtk_tree_selection_count_selected_rows ##### -->
<para>
</para>
@selection:
@Returns:
<!-- ##### FUNCTION gtk_tree_selection_select_path ##### -->
<para>
@ -224,6 +243,16 @@ selected rows. It will be called on every selected row in the view.
@end_path:
<!-- ##### FUNCTION gtk_tree_selection_unselect_range ##### -->
<para>
</para>
@selection:
@start_path:
@end_path:
<!-- ##### SIGNAL GtkTreeSelection::changed ##### -->
<para>
Emitted whenever the selection has (possibly) changed. Please note that

40
docs/reference/gtk/tmpl/gtktreestore.sgml
View File

@ -173,3 +173,43 @@ GtkTreeStore
@tree_store:
<!-- ##### FUNCTION gtk_tree_store_iter_is_valid ##### -->
<para>
</para>
@tree_store:
@iter:
@Returns:
<!-- ##### FUNCTION gtk_tree_store_reorder ##### -->
<para>
</para>
@tree_store:
@parent:
@new_order:
<!-- ##### FUNCTION gtk_tree_store_swap ##### -->
<para>
</para>
@tree_store:
@a:
@b:
<!-- ##### FUNCTION gtk_tree_store_move ##### -->
<para>
</para>
@tree_store:
@iter:
@position:

21
docs/reference/gtk/tmpl/gtktreeview.sgml
View File

@ -377,6 +377,18 @@ Function used for #gtk_tree_view_map_expanded_rows.
@start_editing:
<!-- ##### FUNCTION gtk_tree_view_set_cursor_on_cell ##### -->
<para>
</para>
@tree_view:
@path:
@focus_column:
@focus_cell:
@start_editing:
<!-- ##### FUNCTION gtk_tree_view_get_cursor ##### -->
<para>
@ -413,6 +425,15 @@ Function used for #gtk_tree_view_map_expanded_rows.
@tree_view:
<!-- ##### FUNCTION gtk_tree_view_expand_to_path ##### -->
<para>
</para>
@tree_view:
@path:
<!-- ##### FUNCTION gtk_tree_view_expand_row ##### -->
<para>

9
docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
View File

@ -471,6 +471,15 @@ calling gtk_tree_view_column_set_cell_data_func()
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_focus_cell ##### -->
<para>
</para>
@tree_column:
@cell:
<!-- ##### SIGNAL GtkTreeViewColumn::clicked ##### -->
<para>

73
docs/reference/gtk/tmpl/gtkwindow.sgml
View File

@ -403,6 +403,22 @@ Deprecated alias for gtk_window_set_position().
@window:
<!-- ##### FUNCTION gtk_window_fullscreen ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gtk_window_unfullscreen ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gtk_window_begin_resize_drag ##### -->
<para>
@ -485,6 +501,24 @@ Deprecated alias for gtk_window_set_position().
@hint:
<!-- ##### FUNCTION gtk_window_set_skip_taskbar_hint ##### -->
<para>
</para>
@window:
@setting:
<!-- ##### FUNCTION gtk_window_set_skip_pager_hint ##### -->
<para>
</para>
@window:
@setting:
<!-- ##### FUNCTION gtk_window_get_decorated ##### -->
<para>
@ -637,6 +671,24 @@ Deprecated alias for gtk_window_set_position().
@Returns:
<!-- ##### FUNCTION gtk_window_get_skip_taskbar_hint ##### -->
<para>
</para>
@window:
@Returns:
<!-- ##### FUNCTION gtk_window_get_skip_pager_hint ##### -->
<para>
</para>
@window:
@Returns:
<!-- ##### FUNCTION gtk_window_move ##### -->
<para>
@ -683,6 +735,16 @@ Deprecated alias for gtk_window_set_position().
@list:
<!-- ##### FUNCTION gtk_window_set_default_icon_from_file ##### -->
<para>
</para>
@filename:
@err:
@Returns:
<!-- ##### FUNCTION gtk_window_set_icon ##### -->
<para>
@ -701,6 +763,17 @@ Deprecated alias for gtk_window_set_position().
@list:
<!-- ##### FUNCTION gtk_window_set_icon_from_file ##### -->
<para>
</para>
@window:
@filename:
@err:
@Returns:
<!-- ##### FUNCTION gtk_decorated_window_init ##### -->
<para>

13
gdk/gdkwindow.c
View File

@ -402,14 +402,13 @@ _gdk_window_destroy (GdkWindow *window,
* gdk_window_destroy:
* @window: a #GdkWindow
*
* Destroys @window (destroys the server-side resource associated with
* @window). Memory allocated for @window may not be freed until all
* references to @window are dropped. All children of @window are also
* destroyed.
* Destroys the window system resources associated with @window and decrements @window's
* reference count. The window system resources for all children of @window are also
* destroyed, but the children's reference counts are not decremented.
*
* Note that a window will not be destroyed automatically when its reference count
* reaches zero. You must call this function yourself before that happens.
*
* There's normally no need to use this function, window are automatically
* destroyed when their reference count reaches 0.
*
**/
void
gdk_window_destroy (GdkWindow *window)

3
gtk/gtkbox.h
View File

@ -52,7 +52,8 @@ typedef struct _GtkBoxChild GtkBoxChild;
struct _GtkBox
{
GtkContainer container;
/*< public >*/
GList *children;
gint16 spacing;
guint homogeneous : 1;

8
gtk/gtkdialog.c
View File

@ -869,10 +869,10 @@ run_destroy_handler (GtkDialog *dialog, gpointer data)
* @dialog: a #GtkDialog
*
* Blocks in a recursive main loop until the @dialog either emits the
* response signal, or is destroyed. If the dialog is destroyed,
* gtk_dialog_run() returns #GTK_RESPONSE_NONE. Otherwise, it returns
* the response ID from the "response" signal emission. Before
* entering the recursive main loop, gtk_dialog_run() calls
* response signal, or is destroyed. If the dialog is destroyed during the call
* to gtk_dialog_run(), gtk_dialog_returns #GTK_RESPONSE_NONE.
* Otherwise, it returns the response ID from the "response" signal emission.
* Before entering the recursive main loop, gtk_dialog_run() calls
* gtk_widget_show() on the dialog for you. Note that you still
* need to show any children of the dialog yourself.
*

32
gtk/gtkitemfactory.c
View File

@ -1464,10 +1464,22 @@ ifactory_delete_popup_data (GtkObject *object,
* @ifactory: a #GtkItemFactory of type #GTK_TYPE_MENU (see gtk_item_factory_new())
* @x: the x position
* @y: the y position
* @mouse_button: the mouse button which was pressed to initiate this action
* @time: a timestamp for this action
* @mouse_button: the mouse button which was pressed to initiate the popup
* @time: the time at which the activation event occurred
*
* Pops up the menu constructed from the item factory at (@x, @y).
*
* The @mouse_button parameter should be the mouse button pressed to initiate
* the menu popup. If the menu popup was initiated by something other than
* a mouse button press, such as a mouse button release or a keypress,
* @mouse_button should be 0.
*
* The @time parameter should be the time stamp of the event that
* initiated the popup. If such an event is not available, use
* gtk_get_current_event_time() instead.
*
* The operation of the @mouse_button and the @time parameter is the same
* as the @button and @activation_time parameters for gtk_menu_popup().
*/
void
gtk_item_factory_popup (GtkItemFactory *ifactory,
@ -1487,12 +1499,24 @@ gtk_item_factory_popup (GtkItemFactory *ifactory,
* the menu is unposted
* @x: the x position
* @y: the y position
* @mouse_button: the mouse button which was pressed to initiate this action
* @time: a timestamp for this action
* @mouse_button: the mouse button which was pressed to initiate the popup
* @time: the time at which the activation event occurred
*
* Pops up the menu constructed from the item factory at (@x, @y). Callbacks
* can access the @popup_data while the menu is posted via
* gtk_item_factory_popup_data() and gtk_item_factory_popup_data_from_widget().
*
* The @mouse_button parameter should be the mouse button pressed to initiate
* the menu popup. If the menu popup was initiated by something other than
* a mouse button press, such as a mouse button release or a keypress,
* @mouse_button should be 0.
*
* The @time parameter should be the time stamp of the event that
* initiated the popup. If such an event is not available, use
* gtk_get_current_event_time() instead.
*
* The operation of the @mouse_button and the @time parameters is the same
* as the @button and @activation_time parameters for gtk_menu_popup().
*/
void
gtk_item_factory_popup_with_data (GtkItemFactory *ifactory,

26
gtk/gtkmenu.c
View File

@ -684,6 +684,32 @@ popup_grab_on_window (GdkWindow *window,
return FALSE;
}
/**
* gtk_menu_popup:
* @menu: a #GtkMenu.
* @parent_menu_shell: the menu shell containing the triggering menu item, or %NULL
* @parent_menu_item: the menu item whose activation triggered the popup, or %NULL
* @func: a user supplied function used to position the menu, or %NULL
* @data: user supplied data to be passed to @func.
* @button: the mouse button which was pressed to initiate the event.
* @activate_time: the time at which the activation event occurred.
*
* Displays a menu and makes it available for selection. Applications can use
* this function to display context-sensitive menus, and will typically supply
* %NULL for the @parent_menu_shell, @parent_menu_item, @func and @data
* parameters. The default menu positioning function will position the menu
* at the current mouse cursor position.
*
* The @button parameter should be the mouse button pressed to initiate
* the menu popup. If the menu popup was initiated by something other than
* a mouse button press, such as a mouse button release or a keypress,
* @button should be 0.
*
* The @activate_time parameter should be the time stamp of the event that
* initiated the popup. If such an event is not available, use
* gtk_get_current_event_time() instead.
*
*/
void
gtk_menu_popup (GtkMenu *menu,
GtkWidget *parent_menu_shell,

8
gtk/gtktable.c
View File

@ -200,28 +200,28 @@ gtk_table_class_init (GtkTableClass *class)
CHILD_PROP_LEFT_ATTACH,
g_param_spec_uint ("left_attach",
_("Left attachment"),
_("The leftmost column of the child"),
_("The column number to attach the left side of the child to"),
0, 65535, 0,
G_PARAM_READWRITE));
gtk_container_class_install_child_property (container_class,
CHILD_PROP_RIGHT_ATTACH,
g_param_spec_uint ("right_attach",
_("Right attachment"),
_("The rightmost column of the child"),
_("the column number to attach the right side of a child widget to"),
1, 65535, 1,
G_PARAM_READWRITE));
gtk_container_class_install_child_property (container_class,
CHILD_PROP_TOP_ATTACH,
g_param_spec_uint ("top_attach",
_("Top attachment"),
_("The uppermost row of the child"),
_("The row number to attach the top of a child widget to"),
0, 65535, 0,
G_PARAM_READWRITE));
gtk_container_class_install_child_property (container_class,
CHILD_PROP_BOTTOM_ATTACH,
g_param_spec_uint ("bottom_attach",
_("Bottom attachment"),
_("The lowest row of the child"),
_("The row number to attach the bottom of the child to"),
1, 65535, 1,
G_PARAM_READWRITE));
gtk_container_class_install_child_property (container_class,

4
gtk/gtkwindow.c
View File

@ -2116,7 +2116,9 @@ gtk_window_set_geometry_hints (GtkWindow *window,
* managers</link> allow GTK+ to disable these decorations, creating a
* borderless window. If you set the decorated property to %FALSE
* using this function, GTK+ will do its best to convince the window
* manager not to decorate the window.
* manager not to decorate the window. Depending on the system, this
* function may not have any effect when called on a window that is
* already visible, so you should call it before calling gtk_window_show().
*
* On Windows, this function always works, since there's no window manager
* policy involved.