From acbb5af54bcbdcb2dc561954395cfa25f09fcb5c Mon Sep 17 00:00:00 2001
From: Albrecht Schlosser <albrechts.fltk@online.de>
Date: Sun, 28 Sep 2008 22:25:23 +0000
Subject: doxygen docs for some missing Fl_Group methods, updated Fl::focus().

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6351 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 FL/Fl.H       |  2 +-
 FL/Fl_Group.H | 12 ++++++++++--
 2 files changed, 11 insertions(+), 3 deletions(-)

(limited to 'FL')

diff --git a/FL/Fl.H b/FL/Fl.H
index 88d963d5c..e11e924d4 100644
--- a/FL/Fl.H
+++ b/FL/Fl.H
@@ -537,7 +537,7 @@ public:
   /** See Fl_Widget* pushed(Fl_Widget*) */
   static Fl_Widget* pushed()	{return pushed_;}
   static void pushed(Fl_Widget*);
-  /** See Fl_Widget* focus(Fl_Widget*) */
+  /** Gets the current Fl::focus() widget. \sa Fl::focus(Fl_Widget*) */
   static Fl_Widget* focus()	{return focus_;}
   static void focus(Fl_Widget*);
   static void add_handler(int (*h)(int));
diff --git a/FL/Fl_Group.H b/FL/Fl_Group.H
index ac821cc9a..9155fb521 100644
--- a/FL/Fl_Group.H
+++ b/FL/Fl_Group.H
@@ -166,9 +166,17 @@ public:
   void add_resizable(Fl_Widget& o) {resizable_ = &o; add(o);}
   void init_sizes();
 
-  // back compatibility function:
-  void focus(Fl_Widget* o) {o->take_focus();}
+  // back compatibility functions:
+
+  /**
+    \deprecated This is for backwards compatibility only. You should use
+    \e W->%take_focus() instead.
+    \sa Fl_Widget::take_focus();
+  */
+  void focus(Fl_Widget* W) {W->take_focus();}
+  /** This is for forms compatibility only */
   Fl_Widget* & _ddfdesign_kludge() {return resizable_;}
+  /** This is for forms compatibility only */
   void forms_end();
 };
 
-- 
cgit v1.2.3