[gtkmm] Regenerate XML docs files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerate XML docs files.
- Date: Tue, 18 Mar 2014 11:46:38 +0000 (UTC)
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 "relative" 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 "reverse-engineer" 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 "fake root coordinate"
+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 "fake root" 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]