diff --git a/src/screen_xywh.cxx b/src/screen_xywh.cxx
index 60ad0028732cb8ce84cab5b57a3a9f5444de5f53..2fedf86faf380ed6d318bc996bb5fdef85ca72b2 100644
--- a/src/screen_xywh.cxx
+++ b/src/screen_xywh.cxx
@@ -82,6 +82,7 @@ void Fl::screen_xywh(int &X, int &Y, int &W, int &H, int mx, int my)
  that contains the specified screen position \p mx, \p my
  \param[out]  X,Y,W,H the work area bounding box
  \param[in] mx, my the absolute screen position
+ \see void screen_work_area(int &x, int &y, int &w, int &h, int n)
  */
 void Fl::screen_work_area(int &X, int &Y, int &W, int &H, int mx, int my)
 {
@@ -94,6 +95,9 @@ void Fl::screen_work_area(int &X, int &Y, int &W, int &H, int mx, int my)
  \param[out]  X,Y,W,H the work area bounding box
  \param[in] n the screen number (0 to Fl::screen_count() - 1)
  \see void screen_xywh(int &x, int &y, int &w, int &h, int mx, int my)
+ \note Under X11, the screen work area is given values that differ from that screen's bounding box
+ only if the system contains a single screen. Under Wayland, a screen work area is always
+ equal to that screen's bounding box.
  \note Like all quantities accessible via public APIs of FLTK, values of \p X,Y,W,H
  are given in FLTK units, that is, in drawing units divided by the scaling factor of screen \p n.
 */
@@ -192,7 +196,7 @@ void Fl::screen_xywh(int &X, int &Y, int &W, int &H)
 /**
  Gets the bounding box of the work area of the screen that contains the mouse pointer.
  \param[out]  X,Y,W,H the work area bounding box
- \see void screen_work_area(int &x, int &y, int &w, int &h, int mx, int my)
+ \see void screen_work_area(int &x, int &y, int &w, int &h, int n)
  */
 void Fl::screen_work_area(int &X, int &Y, int &W, int &H)
 {