From 2a7d1909259ba18ff17e059090c647a111f34a7c Mon Sep 17 00:00:00 2001 From: John Finlay Date: Sun, 18 Sep 2005 01:53:20 +0000 Subject: Add descriptions. * pygtk-gobject-functions.xml (spawn_async, child_watch_add) (main_depth, get_current_time) : Add descriptions. * pygtk-gobject-constants.xml (Spawn Flag Constants): Add. * pygtk-gtkobject.xml (gtk.binding_entry_remove): Add. * pygtk-gtk-functions.xml (gtk.binding_entry_add_signal): Move function description to gtk.Object class description. Fix varname errors (#316022 Nikos Kouremenos). * pygtk2-ref.xml: Change date and bump version number. * pygtk-hierarchy.xml: Update. * pygtk-pangocairocairocontext.xml : Add class description. * pygtk-pangocairocairofontmap.xml : Add class description. * pygtk-pangocairo-constants.xml : Add. * pygtk-pangocairo-functions.xml : Add. * pygtk-pangolayoutline.xml : Add class description. * pygtk-pangolayoutiter.xml (get_line): Add. * pygtk-gdkdrawable.xml (cairo_create): Add. * pygtk-pangorenderer.xml: Add pango.Renderer class description. * pygtk-gdkpangorenderer.xml: Add gtk.gdk.PangoRenderer class description. * pygtk-pango-constants.xml (pango.RENDER_PART): Add. * pygtk-gdkdragcontext.xml (set_icon_name): Remove. * pygtk-gdkwindow.xml (set_urgency_hint): Remove. * pygtk-gtktreeview.xml (get_visible_range): Remove. * pygtk-gtkwidget.xml (drag_source_add_image_targets) (drag_source_add_uri_targets, drag_source_set_icon_name): Remove. * pygtk-gtkdialog.xml (gtk.alternative_dialog_button_order): Remove. * pygtk-gtk-functions.xml (gtk.alternative_dialog_button_order): Remove. * pygtk-gtkclipboard.xml (request_image, wait_for_image, set_image) (wait_is_image_available): Remove. * pygtk-gtkaboutdialog.xml (gtk.about_dialog_set_email_hook) (gtk.about_dialog_set_url_hook): Add description of callback function. --- docs/reference/ChangeLog | 60 ++++++ docs/reference/pygtk-gdk-classes.xml | 2 + docs/reference/pygtk-gdk-functions.xml | 88 ++++++++ docs/reference/pygtk-gdkdragcontext.xml | 8 +- docs/reference/pygtk-gdkdrawable.xml | 32 +++ docs/reference/pygtk-gdkwindow.xml | 8 +- docs/reference/pygtk-gobject-constants.xml | 68 ++++++ docs/reference/pygtk-gobject-functions.xml | 336 +++++++++++++++++++++++++++++ docs/reference/pygtk-gtk-functions.xml | 79 ++----- docs/reference/pygtk-gtkaboutdialog.xml | 29 +++ docs/reference/pygtk-gtkclipboard.xml | 30 +-- docs/reference/pygtk-gtkdialog.xml | 14 +- docs/reference/pygtk-gtkiconsource.xml | 12 +- docs/reference/pygtk-gtkiconview.xml | 4 +- docs/reference/pygtk-gtkobject.xml | 108 +++++++++- docs/reference/pygtk-gtkselectiondata.xml | 2 +- docs/reference/pygtk-gtktoolbutton.xml | 4 +- docs/reference/pygtk-gtktreeview.xml | 8 +- docs/reference/pygtk-gtkwidget.xml | 28 ++- docs/reference/pygtk-hierarchy.xml | 7 + docs/reference/pygtk-pango-classes.xml | 2 + docs/reference/pygtk-pango-constants.xml | 45 +++- docs/reference/pygtk-pangolayout.xml | 67 +++--- docs/reference/pygtk-pangolayoutiter.xml | 31 +++ docs/reference/pygtk2-ref.xml | 12 +- 25 files changed, 949 insertions(+), 135 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 95e4d267..f82c5ecf 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,63 @@ + ======== 2.8.1 ============ +2005-09-17 John Finlay + + * pygtk-gobject-functions.xml (spawn_async, child_watch_add) + (main_depth, get_current_time) : Add descriptions. + + * pygtk-gobject-constants.xml (Spawn Flag Constants): Add. + + * pygtk-gtkobject.xml (gtk.binding_entry_remove): Add. + * pygtk-gtk-functions.xml (gtk.binding_entry_add_signal): + Move function description to gtk.Object class description. Fix + varname errors (#316022 Nikos Kouremenos). + + * pygtk2-ref.xml: Change date and bump version number. + + * pygtk-hierarchy.xml: Update. + + * pygtk-pangocairocairocontext.xml : Add class description. + + * pygtk-pangocairocairofontmap.xml : Add class description. + + * pygtk-pangocairo-constants.xml : Add. + + * pygtk-pangocairo-functions.xml : Add. + + * pygtk-pangolayoutline.xml : Add class description. + + * pygtk-pangolayoutiter.xml (get_line): Add. + +2005-09-16 John Finlay + + * pygtk-gdkdrawable.xml (cairo_create): Add. + + * pygtk-pangorenderer.xml: Add pango.Renderer class description. + + * pygtk-gdkpangorenderer.xml: Add gtk.gdk.PangoRenderer class + description. + + * pygtk-pango-constants.xml (pango.RENDER_PART): Add. + + * pygtk-gdkdragcontext.xml (set_icon_name): Remove. + + * pygtk-gdkwindow.xml (set_urgency_hint): Remove. + + * pygtk-gtktreeview.xml (get_visible_range): Remove. + + * pygtk-gtkwidget.xml (drag_source_add_image_targets) + (drag_source_add_uri_targets, drag_source_set_icon_name): Remove. + + * pygtk-gtkdialog.xml (gtk.alternative_dialog_button_order): Remove. + + * pygtk-gtk-functions.xml (gtk.alternative_dialog_button_order): + Remove. + + * pygtk-gtkclipboard.xml (request_image, wait_for_image, set_image) + (wait_is_image_available): Remove. + + * pygtk-gtkaboutdialog.xml (gtk.about_dialog_set_email_hook) + (gtk.about_dialog_set_url_hook): Add description of callback function. + ======== 2.8.0 ============ 2005-09-07 John Finlay diff --git a/docs/reference/pygtk-gdk-classes.xml b/docs/reference/pygtk-gdk-classes.xml index 7b38499c..613d1c25 100644 --- a/docs/reference/pygtk-gdk-classes.xml +++ b/docs/reference/pygtk-gdk-classes.xml @@ -7,6 +7,7 @@ + @@ -19,6 +20,7 @@ + diff --git a/docs/reference/pygtk-gdk-functions.xml b/docs/reference/pygtk-gdk-functions.xml index 4386b878..469ff609 100644 --- a/docs/reference/pygtk-gdk-functions.xml +++ b/docs/reference/pygtk-gdk-functions.xml @@ -165,6 +165,17 @@ linkend="function-gdk--unicode-to-keyval">gtk.gdk.unicode_to_keyval + + <link linkend="class-gdkpangorenderer"><classname>gtk.gdk.PangoRenderer</classname></link> Functions + + + gtk.gdk.gdk_pango_renderer_get_default + screen + + + + <link linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link> Functions @@ -556,6 +567,14 @@ linkend="function-gdk--get-display">gtk.gdk.get_display gtk.gdk.get_display_arg_name + + gtk.gdk.gdk_pango_context_get_for_screen + screen + + gtk.gdk.gdk_pango_context_get @@ -1425,6 +1444,75 @@ returns the display name specified in the command line arguments, if any or + + gtk.gdk.gdk_pango_context_get_for_screen + + + gtk.gdk.gdk_pango_context_get_for_screen + screen + + + + screen : + a gtk.gdk.Screen + + + Returns : + a new pango.Context +object + + + + + This function is available in PyGTK 2.8 and above + + + The +gtk.gdk.gdk_pango_context_get_for_screen() function +creates a new pango.Context +object for the gtk.gdk.Screen +specified by screen. Normally you should use the +get_pango_context() +method instead of this function, to get the appropriate Pango context for +the widget you intend to render text onto. + + + + + gtk.gdk.gdk_pango_context_get + + + gtk.gdk.gdk_pango_context_get + + + + Returns : + a new pango.Context +for the default display. + + + + + This function is available in PyGTK 2.8 and above + + + The gtk.gdk.gdk_pango_context_get() +function creates a new pango.Context for +the default display. Normally you should use the get_pango_context() +method instead of this function, to get the appropriate Pango context for +the widget you intend to render text onto. + + + diff --git a/docs/reference/pygtk-gdkdragcontext.xml b/docs/reference/pygtk-gdkdragcontext.xml index 6e4734b5..f21a2d0c 100644 --- a/docs/reference/pygtk-gdkdragcontext.xml +++ b/docs/reference/pygtk-gdkdragcontext.xml @@ -156,9 +156,10 @@ linkend="method-gdkdragcontext--set-icon-stock">set_icon_stockhot_y + set_icon_default @@ -1059,7 +1061,8 @@ stock icon. - + gtk.gdk.DragContext.set_icon_default diff --git a/docs/reference/pygtk-gdkdrawable.xml b/docs/reference/pygtk-gdkdrawable.xml index db17f185..f72fccf0 100644 --- a/docs/reference/pygtk-gdkdrawable.xml +++ b/docs/reference/pygtk-gdkdrawable.xml @@ -357,6 +357,11 @@ linkend="method-gdkdrawable--draw-gray-image">draw_gray_image END NOT IMPLEMENTED --> + + cairo_create + + @@ -2066,6 +2071,33 @@ grayscale image on the drawable at the location specified by END NOT IMPLEMENTED --> + + gtk.gdk.Drawable.cairo_create + + + cairo_create + + + + + Returns : + a gtk.gdk.CairoContext + + + + + This method is available in PyGTK 2.8 and above. + + + The cairo_create() method returns a +gtk.gdk.CairoContext +object to be used for drawing on the drawable using Cairo drawing +operations. + + + diff --git a/docs/reference/pygtk-gdkwindow.xml b/docs/reference/pygtk-gdkwindow.xml index df59eba1..53ae9198 100644 --- a/docs/reference/pygtk-gdkwindow.xml +++ b/docs/reference/pygtk-gdkwindow.xml @@ -628,10 +628,12 @@ END NOT IMPLEMENTED --> set_focus_on_map focus_on_map + @@ -3796,7 +3798,8 @@ extension specification should respect it. - + diff --git a/docs/reference/pygtk-gobject-constants.xml b/docs/reference/pygtk-gobject-constants.xml index 02ed5a93..27ab5c2e 100644 --- a/docs/reference/pygtk-gobject-constants.xml +++ b/docs/reference/pygtk-gobject-constants.xml @@ -16,6 +16,7 @@ + @@ -240,6 +241,73 @@ emission. + + GObject Spawn Flag Constants + + The Spawn Flag constants are a set of bit-flags that can be +passed to the gobject.spawn_async() +function. + + + + gobject.SPAWN_LEAVE_DESCRIPTORS_OPEN + + the parent's open file descriptors will be inherited by +the child; otherwise all descriptors except stdin/stdout/stderr will be +closed before calling exec() in the child. + + + + gobject.SPAWN_DO_NOT_REAP_CHILD + + the child will not be automatically reaped; you must +call waitpid() or handle SIGCHLD +yourself, or the child will become a zombie. + + + + gobject.SPAWN_SEARCH_PATH + + argv[0] need not be an absolute +path, it will be looked for in the user's PATH. + + + + gobject.SPAWN_STDOUT_TO_DEV_NULL + + the child's standard output will be discarded, instead +of going to the same location as the parent's standard output. + + + + gobject.SPAWN_STDERR_TO_DEV_NULL + + the child's standard error will be discarded. + + + + gobject.SPAWN_CHILD_INHERITS_STDIN + + the child will inherit the parent's standard input (by +default, the child's standard input is attached to /dev/null). + + + + gobject.SPAWN_FILE_AND_ARGV_ZERO + + the first element of argv is the +file to execute, while the remaining elements are the actual argument vector +to pass to the file. Normally gobject.spawn_async() +uses argv[0] as the file to execute, and passes all +of argv to the child. + + + + + + GObject Built-in Type Constants diff --git a/docs/reference/pygtk-gobject-functions.xml b/docs/reference/pygtk-gobject-functions.xml index bf8b8e90..6a186765 100644 --- a/docs/reference/pygtk-gobject-functions.xml +++ b/docs/reference/pygtk-gobject-functions.xml @@ -114,6 +114,30 @@ linkend="function-gobject--main-context-default">gobject.main_context_defaultgobject.markup_escape_text text + + gobject.child_watch_add + pid + function + dataNone + prioritygobject.PRIORITY_DEFAULT + + gobject.spawn_async + argv + envpNone + working_directoryNone + flags0 + child_setupNone + user_dataNone + standard_inputNone + standard_outputNone + standard_errorNone + + gobject.get_current_time + + gobject.main_depth @@ -1032,6 +1056,318 @@ line endings and attribute values. + + gobject.child_watch_add + + + gobject.child_watch_add + pid + function + dataNone + prioritygobject.PRIORITY_DEFAULT + + + + pid : + process id of a child process to watch + + function : + the function to call + + + data : + the optional data to pass to +function + + + priority : + the priority of the idle source - one of the + + + + Returns : + the id of event source. + + + + This function is available in PyGTK 2.6 and above. + + + The gobject.child_watch_add() function sets +the function specified by function to be called with +the user data specified by data when the child +indicated by pid exits. The signature for the +callback is: + + +def callback(pid, condition, user_data) + + + where pid is is the child process id, +condition is the status information about the child +process and user_data is data +PyGTK supports only a single callback per process id. + + + + + gobject.spawn_async + + + gobject.spawn_async + argv + envpNone + working_directoryNone + flags0 + child_setupNone + user_dataNone + standard_inputNone + standard_outputNone + standard_errorNone + + + + argv : + a sequence of strings containing the arguments +of the child process + + + envp : + the child's environment or +None to inherit the parent's +environment. + + + working_directory : + the child's current working directory, or +None to inherit parent's + + + flags : + flags from the . + + + child_setup : + a function to run in the child just before +calling exec() + + + user_data : + the user data for the +child_setup function + + + standard_input : + if TRUE return the file +descriptor for the child's stdin + + + standard_output : + if TRUE return the file +descriptor for the child's stdout + + + standard_error : + if TRUE return the file +descriptor for the child's stderr + + + Returns : + a 4-tuple containing the child's process id and +the stdin, stdout and stderr file descriptor integers. + + + + This function is available in PyGTK 2.6 and above. + + + The gobject.spawn_async() function executes +a child program asynchronously (your program will not block waiting for the +child to exit). The child program is specified by the only argument that +must be provided, argv. argv +should be a sequence of strings, to be passed as the argument vector for the +child. The first string in argv is of course the name +of the program to execute. By default, the name of the program must be a +full path; the PATH shell variable will only be searched if +you pass the gobject.SPAWN_SEARCH_PATH flag in +flags. The function returns a 4-tuple containing the +child's process id and the file descriptors for the child's stdin, stdout +and stderr. The stdin, stdout and stderr file descriptors are returned only +ofthe corresponding standard_input, +standard_output or +standard_error params are +TRUE. + + On Windows, the low-level child process creation API +(CreateProcess()) doesn't use argument vectors, but a +command line. The C runtime library's spawn*() family +of functions (which gobject.spawn_async() +eventually calls) paste the argument vector elements into a command line, +and the C runtime startup code does a corresponding reconstruction of an +argument vector from the command line, to be passed to +main(). Complications arise when you have argument +vector elements that contain spaces of double quotes. The +spawn*() functions don't do any quoting or escaping, +but on the other hand the startup code does do unquoting and unescaping in +order to enable receiving arguments with embedded spaces or double +quotes. To work around this asymmetry, the gobject.spawn_async() +function will do quoting and escaping on argument vector elements that need +it before calling the C runtime spawn() +function. + + envp is a sequence of strings, where each + string has the form KEY=VALUE. This will become the + child's environment. If envp is + None or not specified, the child inherits its + parent's environment. + + flags should be the bitwise +OR of the you want to affect the +function's behaviour. The gobject.SPAWN_DO_NOT_REAP_CHILD +flag means that the child will not automatically be reaped; you must use a +GChildWatch source to be notified about the death of the child +process. Eventually you must call g_spawn_close_pid() on the child_pid, in +order to free resources which may be associated with the child process. (On +Unix, using a GChildWatch source is equivalent to calling +waitpid() or handling the SIGCHLD +signal manually. On Windows, calling g_spawn_close_pid() is equivalent to +calling CloseHandle() on the process handle +returned). + + gobject.SPAWN_LEAVE_DESCRIPTORS_OPEN means +that the parent's open file descriptors will be inherited by the child; +otherwise all descriptors except stdin/stdout/stderr will be closed before +calling exec() in the +child. gobject.SPAWN_SEARCH_PATH means that +argv[0] need not be an absolute path, it will be +looked for in the user's +PATH. gobject.SPAWN_STDOUT_TO_DEV_NULL +means that the child's standard output will be discarded, instead of going +to the same location as the parent's standard output. If you use this flag, +standard_output must be +None. gobject.SPAWN_STDERR_TO_DEV_NULL +means that the child's standard error will be discarded, instead of going to +the same location as the parent's standard error. If you use this flag, +standard_error must be +None. gobject.SPAWN_CHILD_INHERITS_STDIN +means that the child will inherit the parent's standard input (by default, +the child's standard input is attached to +/dev/null). If you use this flag, +standard_input must be +None. gobject.SPAWN_FILE_AND_ARGV_ZERO +means that the first element of argv is the file to +execute, while the remaining elements are the actual argument vector to pass +to the file. Normally the gobject.spawn_async() +function uses argv[0] as the file to execute, and +passes all of argv to the child. + + child_setup and +user_data are a function and user data. On POSIX +platforms, the function is called in the child after GLib has performed all +the setup it plans to perform (including creating pipes, closing file +descriptors, etc.) but before calling exec(). That is, +child_setup is called just before calling +exec() in the child. Obviously actions taken in this +function will only affect the child, not the parent. On Windows, there is no +separate fork() and exec() +functionality. Child processes are created and run right away with one API +call, +CreateProcess(). child_setup is +called in the parent process just before creating the child process. You +should carefully consider what you do in child_setup +if you intend your software to be portable to Windows. + + The returned child process id can be used to send signals to the +child, or to wait for the child if you specified the +gobject.SPAWN_DO_NOT_REAP_CHILD flag. On Windows, child +pid will be returned only if you specified the +gobject.SPAWN_DO_NOT_REAP_CHILD flag. + + The caller of the gobject.spawn_async() +must close any returned file descriptors when they are no longer in +use. + + If standard_input is +None, the child's standard input is attached to +/dev/null unless +gobject.SPAWN_CHILD_INHERITS_STDIN is set. + + If standard_error is +None, the child's standard error goes to the same +location as the parent's standard error unless +gobject.SPAWN_STDERR_TO_DEV_NULL is set. + + If standard_output is +None, the child's standard output goes to the same +location as the parent's standard output unless +gobject.SPAWN_STDOUT_TO_DEV_NULL is set. + + If an error occurs, the gobject.GError exception will be +raised. + + + + + gobject.get_current_time + + + gobject.get_current_time + + + + Returns : + the current time as the number of seconds and +microseconds from the epoch. + + + + This function is available in PyGTK 2.8 and above. + + + The gobject.get_current_time() function +reurns the current time of day as the number of seconds and microseconds +from the epoch. + + + + + gobject.main_depth + + + gobject.main_depth + + + + Returns : + he depth of the stack of calls to the main +context. + + + + This function is available in PyGTK 2.8 and above. + + + The main_depth() function returns the depth +of the stack of calls in the main context. That is, when called from the +toplevel, it gives 0. When called from within a callback from the gobject.MainContext.iteration() +method (or the gobject.MainLoop.run() +method, etc.) it returns 1. When called from within a callback to a +recursive call to the gobject.MainContext.iteration() +method), it returns 2. And so forth. + + + diff --git a/docs/reference/pygtk-gtk-functions.xml b/docs/reference/pygtk-gtk-functions.xml index 6422054c..9075f0ba 100644 --- a/docs/reference/pygtk-gtk-functions.xml +++ b/docs/reference/pygtk-gtk-functions.xml @@ -184,6 +184,19 @@ linkend="function-gtk--clipboard-get">gtk.clipboard_get + + <link linkend="class-gtkexpander"><classname>gtk.Expander</classname></link> Functions @@ -322,6 +335,14 @@ linkend="function-gtk--bindings-activate">gtk.bindings_activate_eventobject event + + gtk.binding_entry_add_signal + object + keyval + modifiers + signal_name + ... @@ -556,14 +577,6 @@ linkend="function-gtk--window-set-default-icon-name">gtk.window_set_default_icon gtk.binding_entry_add_signal - object - keyval - modifiers - signal_name - ... - - gtk.check_version required_major @@ -666,56 +679,6 @@ that are not associated with a specific class are described below. Functions - - gtk.binding_entry_add_signal - - - gtk.binding_entry_add_signal - class - keyval - modifiers - signal_name - ... - - - - object : - the gtk.Object -class the binding entry will be associated with - - - keyval : - the key value - - - modifiers : - the modifier mask - - - signal_name : - the signal name - - - ... : - zero or more pairs of value type-value -pairs - - - - The gtk.binding_entry_add_signal() function -adds a binding (specified by keyval and -modifiers) to the binding set of the specified object -class. The signal specified by -signal_name will be emitted with the optional -arguments specified by the argument pairs denoted by ... that are value type -and value. This function is used when creating a new widget class to set up -key bindings. - - - gtk.check_version diff --git a/docs/reference/pygtk-gtkaboutdialog.xml b/docs/reference/pygtk-gtkaboutdialog.xml index 2e88bc0a..87264a64 100644 --- a/docs/reference/pygtk-gtkaboutdialog.xml +++ b/docs/reference/pygtk-gtkaboutdialog.xml @@ -1094,6 +1094,21 @@ activated. function installs a global function (specified by func) to be called whenever the user activates an email link in an about dialog. + + The signature of the callback function +func is: + + +def func(dialog, link, user_data) + + + where link is the email address +destination of the activated link, dialog is the +gtk.AboutDialog +containing link and user_data +is the data argument passed to gtk.about_dialog_set_email_hook(). @@ -1128,6 +1143,20 @@ activated. installs a global function (specified by func) to be called whenever the user activates a URL link in an about dialog. + The signature of the callback function +func is: + + +def func(dialog, link, user_data) + + + where link is the URL destination of the +activated link, dialog is the gtk.AboutDialog +containing link and user_data +is the data argument passed to gtk.about_dialog_set_url_hook(). + diff --git a/docs/reference/pygtk-gtkclipboard.xml b/docs/reference/pygtk-gtkclipboard.xml index 3f2869e9..790eb917 100644 --- a/docs/reference/pygtk-gtkclipboard.xml +++ b/docs/reference/pygtk-gtkclipboard.xml @@ -82,23 +82,25 @@ store + @@ -875,7 +877,8 @@ quit. - + diff --git a/docs/reference/pygtk-gtkdialog.xml b/docs/reference/pygtk-gtkdialog.xml index 9c1d5c54..61c01525 100644 --- a/docs/reference/pygtk-gtkdialog.xml +++ b/docs/reference/pygtk-gtkdialog.xml @@ -96,16 +96,18 @@ linkend="method-gtkdialog--get-response-for-widget">get_response_for_widgetwidget - + + + @@ -770,10 +772,11 @@ returns the response id of the widget specified by + Signals diff --git a/docs/reference/pygtk-gtkiconsource.xml b/docs/reference/pygtk-gtkiconsource.xml index d2927f6f..cb46bfb0 100644 --- a/docs/reference/pygtk-gtkiconsource.xml +++ b/docs/reference/pygtk-gtkiconsource.xml @@ -688,11 +688,17 @@ to This method is available in PyGTK 2.4 and above. - The set_icon_name() method sets the -anme of the icon to look up in the current icon theme to use as a base image -when creating icon variants for The set_icon_name() method uses the +name specified by icon_name to look up an icon in the +current icon theme to use as a base image when creating icon variants for +gtk.IconSet. + + diff --git a/docs/reference/pygtk-gtkiconview.xml b/docs/reference/pygtk-gtkiconview.xml index 92543b57..799e48f2 100644 --- a/docs/reference/pygtk-gtkiconview.xml +++ b/docs/reference/pygtk-gtkiconview.xml @@ -1881,8 +1881,8 @@ drag-and-drop. path : - the path of the item to highlight, or -None. + the path of the item to highlight. pos : diff --git a/docs/reference/pygtk-gtkobject.xml b/docs/reference/pygtk-gtkobject.xml index 1042ba08..af1bfa57 100644 --- a/docs/reference/pygtk-gtkobject.xml +++ b/docs/reference/pygtk-gtkobject.xml @@ -54,7 +54,24 @@ linkend="function-gtk--bindings-activate-event">gtk.bindings_activate_eventobject event - + + gtk.binding_entry_add_signal + object + keyval + modifiers + signal_name + ... + + gtk.binding_entry_remove + class_type + keyval + modifiers + @@ -496,6 +513,95 @@ it. + + gtk.binding_entry_add_signal + + + gtk.binding_entry_add_signal + object + keyval + modifiers + signal_name + ... + + + + object : + the gtk.Object +class the binding entry will be associated with + + + keyval : + the key value + + + modifiers : + the modifier mask + + + signal_name : + the signal name + + + ... : + zero or more pairs of value type-value +pairs + + + + The gtk.binding_entry_add_signal() function +adds a binding (specified by keyval and +modifiers) to the binding set of the object class +derived from object. The signal specified by +signal_name will be emitted with the optional +arguments specified by the argument pairs denoted by ... that are value type +and value. This function is used when creating a new widget class to set up +key bindings. + + + + + gtk.binding_entry_remove + + + gtk.binding_entry_remove + class_type + keyval + modifiers + + + + class_type : + the gtk.Object +class the binding entry will be removed from + + + keyval : + the key value + + + modifiers : + the modifier mask + + + + + This function is available in PyGTK 2.2 and above. + + + The gtk.binding_entry_remove() function +removes the binding (specified by keyval and +modifiers) from the binding set of the object class +specified by class_type. + + + diff --git a/docs/reference/pygtk-gtkselectiondata.xml b/docs/reference/pygtk-gtkselectiondata.xml index 49013a89..f0d9a41c 100644 --- a/docs/reference/pygtk-gtkselectiondata.xml +++ b/docs/reference/pygtk-gtkselectiondata.xml @@ -516,7 +516,7 @@ the selection data was successfully set. The get_uris() method returns the -contents of the selection data as a list or URIs. +contents of the selection data as a list of URIs. diff --git a/docs/reference/pygtk-gtktoolbutton.xml b/docs/reference/pygtk-gtktoolbutton.xml index a105238c..445aab30 100644 --- a/docs/reference/pygtk-gtktoolbutton.xml +++ b/docs/reference/pygtk-gtktoolbutton.xml @@ -479,8 +479,8 @@ more information. icon_name : - a name of a themed icon, or -None + a name of a themed icon, diff --git a/docs/reference/pygtk-gtktreeview.xml b/docs/reference/pygtk-gtktreeview.xml index d946bd19..1468a05b 100644 --- a/docs/reference/pygtk-gtktreeview.xml +++ b/docs/reference/pygtk-gtktreeview.xml @@ -444,9 +444,11 @@ END NOT IMPLEMENTED --> funcNone user_dataNone + @@ -3248,7 +3250,8 @@ separator. - + diff --git a/docs/reference/pygtk-gtkwidget.xml b/docs/reference/pygtk-gtkwidget.xml index 6eef8f0e..8643cb83 100644 --- a/docs/reference/pygtk-gtkwidget.xml +++ b/docs/reference/pygtk-gtkwidget.xml @@ -150,27 +150,31 @@ linkend="method-gtkwidget--drag-source-set-icon-stock">drag_source_set_icon_stoc stock_id + drag_source_add_text_targets + drag_begin @@ -2525,7 +2529,8 @@ stock icon specified by stock_id. - + gtk.Widget.drag_source_get_target_list @@ -2643,7 +2649,8 @@ method. - + gtk.Widget.drag_begin diff --git a/docs/reference/pygtk-hierarchy.xml b/docs/reference/pygtk-hierarchy.xml index 604f1a11..40640f87 100644 --- a/docs/reference/pygtk-hierarchy.xml +++ b/docs/reference/pygtk-hierarchy.xml @@ -23,6 +23,7 @@ pango.FontMetrics pango.GlyphString pango.Language + pango.LayoutLine pango.TabArray gobject.GInterface gtk.CellEditable @@ -215,9 +216,15 @@ pango.FontFace pango.FontFamily pango.FontMap + pangocairo.CairoFontMap pango.Fontset pango.FontsetSimple pango.Layout + pango.Renderer + gtk.gdk.PangoRenderer gobject.GPointer +cairo.Context + pangocairo.CairoContext + gtk.gdk.CairoContext diff --git a/docs/reference/pygtk-pango-classes.xml b/docs/reference/pygtk-pango-classes.xml index 189a57b3..80e0203a 100644 --- a/docs/reference/pygtk-pango-classes.xml +++ b/docs/reference/pygtk-pango-classes.xml @@ -23,6 +23,8 @@ + + diff --git a/docs/reference/pygtk-pango-constants.xml b/docs/reference/pygtk-pango-constants.xml index c89af664..5519ebb5 100644 --- a/docs/reference/pygtk-pango-constants.xml +++ b/docs/reference/pygtk-pango-constants.xml @@ -18,6 +18,7 @@ + @@ -397,6 +398,48 @@ that have been set. + + Pango Render Part Constants + + + + + + pango.RENDER_PART + + The pango.RENDER_PART constants +define different items to render for purposes such as setting +colors. Available since PyGTK 2.8. + + + + pango.RENDER_PART_FOREGROUND + + The text itself. + + + + pango.RENDER_PART_BACKGROUND + + The area behind the text. + + + + pango.RENDER_PART_UNDERLINE + + The underlined areas. + + + + pango.RENDER_PART_STRIKETHROUGH + + The strikethrough areas. + + + + + + Pango Scale Constants @@ -426,7 +469,7 @@ that have been set. pango.SCALE_X_SMALL - he scale factor for two shrinking steps + The scale factor for two shrinking steps (1 / (1.2 * 1.2)). diff --git a/docs/reference/pygtk-pangolayout.xml b/docs/reference/pygtk-pangolayout.xml index 66114a57..c53a7437 100644 --- a/docs/reference/pygtk-pangolayout.xml +++ b/docs/reference/pygtk-pangolayout.xml @@ -205,15 +205,15 @@ linkend="method-pangolayout--get-pixel-size">get_pixel_size get_line_count - + + get_line + line + get_iter @@ -1226,33 +1226,40 @@ count of lines in the layout. - -- cgit v1.2.1