rwm: note that position/dimensions ignore borders

 protocol/river-window-management-v1.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/protocol/river-window-management-v1.xml b/protocol/river-window-management-v1.xml
index 2c266dc..cbfa045 100644
--- a/protocol/river-window-management-v1.xml
+++ b/protocol/river-window-management-v1.xml
@@ -287,6 +287,10 @@
         logical coordinate space. The width and height must be strictly greater
         than zero.
 
+        Note that the dimensions of a river_window_v1 refer to the dimensions of
+        the window content and are unaffected by the presence of borders or
+        decoration surfaces.
+
         This event is double-buffered state and will be followed by a
         river_window_manager_v1.update event.
       </description>
@@ -312,6 +316,10 @@
         propose_dimensions request in the next possible update even if the
         window dimensions are unchanged since the most recent dimensions event.
 
+        Note that the dimensions of a river_window_v1 refer to the dimensions of
+        the window content and are unaffected by the presence of borders or
+        decoration surfaces.
+
         This request is double-buffered state and will not be applied until the
         next river_window_manager_v1.commit request.
       </description>
@@ -469,6 +477,10 @@
         This request completely overrides all previous set_borders requests.
         Only the most recent set_borders request has an effect.
 
+        Note that the position/dimensions of a river_window_v1 refer to the
+        position/dimensions of the window content and are unaffected by the
+        presence of borders or decoration surfaces.
+
         This request is double-buffered state and will not be applied until the
         next river_window_manager_v1.commit request.
       </description>
@@ -834,6 +846,10 @@
         Set the absolute position of the node in the compositor's logical
         coordinate space. The x and y coordinates may be positive or negative.
 
+        Note that the position of a river_window_v1 refers to the position of
+        the window content and is unaffected by the presence of borders or
+        decoration surfaces.
+
         If this request is never sent, the position of the node is undefined by
         this protocol and left up to the compositor.
 
@@ -850,6 +866,10 @@
         logical coordinate space. The x and y coordinates may be positive or
         negative.
 
+        Note that the position of a river_window_v1 refers to the position of
+        the window content and is unaffected by the presence of borders or
+        decoration surfaces.
+
         While the window manager client usually sets the position of the node,
         there are some cases in which the position must be modified by the
         server in which case this event is sent to inform the client of the new