add a comment regarding the client.area() being not-what-you-want

diff --git a/src/client.hh b/src/client.hh
index ff119faf746b12961bbfb296b1de8fdc1576f3f3..8bbe2a918f7490217c4d6b1aa4c4b42438564d1d 100644 (file)
--- a/src/client.hh
+++ b/src/client.hh
@@ -622,6 +622,11 @@ BB    @param window The window id that the Client class should handle
   const otk::Size &logicalSize() const { return _logical_size; }
 
   //! Returns the position and size of the client relative to the root window
+  /*!
+    Note that this value is *not* the size and position of the window's
+    frame, though the position will often line up.<br>
+    If you want the frame's area, use Frame::area() instead.
+  */
   inline const otk::Rect &area() const { return _area; }
 
   //! Returns the client's strut definition