[gtkmm] Regenerate XML docs files.



commit 829a74c3373edb8dd701fb8da86745f57c70bb76
Author: Murray Cumming <murrayc murrayc com>
Date:   Tue Mar 18 12:37:34 2014 +0100

    Regenerate XML docs files.

 gdk/src/gdk_docs.xml |   47 +++++++++++++++++++++++++++++++++++++++++++++++
 gtk/src/gtk_docs.xml |   15 ++++++++++-----
 2 files changed, 57 insertions(+), 5 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index fcfcfe5..ff4e481 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -14203,6 +14203,53 @@ Since: 3.8
 </return>
 </function>
 
+<function name="gdk_wayland_window_get_fake_root_coords">
+<description>
+Wayland does not have a global coordinate space shared between
+surfaces. In fact, for regular toplevels, we have no idea where
+our surfaces are positioned, relatively.
+
+However, there are some cases like popups and subsurfaces where
+we do have some amount of control over the placement of our
+window, and we can semi-accurately control the x/y position of
+these windows, if they are relative to another surface.
+
+GTK+ loves to position &quot;relative&quot; popups like menus in root
+window coordinates, since it was built for display servers that
+have queryable absolute coordinate spaces. In these cases, GTK+
+might ask for the root coordinates of a widget window, add a
+few values, and then call gdk_window_move() with that absolute
+value.
+
+In Wayland, we have to &quot;reverse-engineer&quot; this use, and figure
+out the root coordinates from the relative position, and the
+relative position from the root coordinates.
+
+We invent a coordinate space called the &quot;fake root coordinate&quot;
+space in which a toplevel is always at 0,0, and all popups are
+relative to that space.
+
+gdk_wayland_window_get_fake_root_coords() gives you the
+position of a #GdkWindow in &quot;fake root&quot; coordinates.
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> A #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="x_out">
+<parameter_description> The X offset of this window
+</parameter_description>
+</parameter>
+<parameter name="y_out">
+<parameter_description> The Y offset of this window
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_wayland_window_get_wl_surface">
 <description>
 Returns the Wayland surface of a #GdkWindow
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index af99126..c14ff74 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -17527,7 +17527,7 @@ Since: 3.12
 </parameter_description>
 </parameter>
 <parameter name="detailed_action_name">
-<parameter_description> a detailed action name, specifying and action
+<parameter_description> a detailed action name, specifying an action
 and target to obtain accelerators for
 </parameter_description>
 </parameter>
@@ -17858,7 +17858,7 @@ Since: 3.12
 </parameter_description>
 </parameter>
 <parameter name="detailed_action_name">
-<parameter_description> a detailed action name, specifying and action
+<parameter_description> a detailed action name, specifying an action
 and target to associate accelerators with
 </parameter_description>
 </parameter>
@@ -56102,14 +56102,16 @@ Since: 3.12
 
 <function name="gtk_popover_new">
 <description>
- relative_to (allow-none): #GtkWidget the popover is related to
-
 Creates a new popover to point to @relative_to
 
 Since: 3.12
 
 </description>
 <parameters>
+<parameter name="relative_to">
+<parameter_description> #GtkWidget the popover is related to
+</parameter_description>
+</parameter>
 </parameters>
 <return> a new #GtkPopover
 
@@ -56233,7 +56235,10 @@ Since: 3.12
 <parameters>
 <parameter name="popover">
 <parameter_description> a #GtkPopover
- relative_to (allow-none): a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="relative_to">
+<parameter_description> a #GtkWidget
 </parameter_description>
 </parameter>
 </parameters>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]