WP1 merged from my branch, WP2 reserved, todo list updated.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6231 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 15 insertions, 3 deletions

diff --git a/src/screen_xywh.cxx b/src/screen_xywh.cxx
index a6c98d304..7a36e19e7 100644
--- a/src/screen_xywh.cxx
+++ b/src/screen_xywh.cxx
@@ -141,14 +141,23 @@ static void screen_init() {
 #endif // WIN32
 
 
-// Return the number of screens...
+/**
+  Gets the number of available screens.
+*/
 int Fl::screen_count() {
   if (!num_screens) screen_init();
 
   return num_screens;
 }
 
-// Return the screen bounding rect for the given mouse position...
+/**
+  Gets the bounding box of a screen. The first form gets the
+  bounding box for the screen the mouse pointer is in. The second
+  form gets the bounding box for the screen that contains the
+  specified coordinates. The last form gets the bounding box for
+  the numbered screen, where n is a number from 0 to the
+  number of screens less 1.
+*/
 void Fl::screen_xywh(int &X, int &Y, int &W, int &H, int mx, int my) {
   if (!num_screens) screen_init();
 
@@ -212,7 +221,10 @@ void Fl::screen_xywh(int &X, int &Y, int &W, int &H, int mx, int my) {
   H = Fl::h();
 }
 
-// Return the screen bounding rect for the given screen...
+/**
+  Returns the screen bounding rect for the given screen. 
+  See void screen_xywh(int &x, int &y, int &w, int &h, int mx, int my) 
+*/
 void Fl::screen_xywh(int &X, int &Y, int &W, int &H, int n) {
   if (!num_screens) screen_init();