Remove deprecated methods and functions

In FLTK 1.5 we remove most (but not all) methods and functions that
were deprecated in FLTK 1.3 or earlier.

1 files changed, 53 insertions, 11 deletions

diff --git a/documentation/src/migration_1_5.dox b/documentation/src/migration_1_5.dox
index cbe98919b..107bfe061 100644
--- a/documentation/src/migration_1_5.dox
+++ b/documentation/src/migration_1_5.dox
@@ -31,8 +31,8 @@ build.
 
 If you use "Modern CMake" (basically CMake in CONFIGURE mode) to build your
 own projects the appropriate options are inherited from the properties of
-the FLTK libraries as well. Otherwise you may need to set the compiler flags
-to use at least C++11 yourself.
+the FLTK libraries. Otherwise you may need to set the compiler flags to use
+at least C++11 yourself.
 
 
 \section migration_1_5_forms Default for FORMS compatibility is now OFF
@@ -61,20 +61,62 @@ FLTK requires C++11 anyway.
 For more details please see \ref migration_1_4_fl_override.
 
 
-\section migration_1_5_deprecated Deprecated methods and functions removed
+\section migration_1_5_removed Removed Methods and Functions
 
 Methods, functions, and global symbols that have been deprecated in FLTK 1.3
-or earlier have been removed. If you need help with those functions because
-your old code still uses one or more of them, please consult the FLTK 1.3 or
-1.4 documentation for how to replace them with newer functions/methods.
+or earlier have been removed in FLTK 1.5.0.
 
-The following (very likely incomplete) list may help to identify such removed
-methods and functions:
+If you need help with these functions because old code still uses them, please
+consult the table below for a quick solution. If this doesn't help please read
+the FLTK 1.3 or 1.4 documentation to find out how to replace them with newer
+functions or methods, for instance https://www.fltk.org/doc-1.4/deprecated.html.
 
-Removed symbol            | Replace with ...
---------------------------|-------------------------
-Fl::release()             | Fl::grab(0)
 
+The following (possibly incomplete) list can help to identify and replace
+these removed methods and functions.
+
+Removed Symbol                          | Please Replace With ...
+----------------------------------------|-------------------------
+Fl::release()                           | Fl::grab(0)
+Fl::set_idle(Fl_Old_Idle_Handler cb)    | Fl::add_idle(cb [, data])
+fl_ask(const char *fmt,...)             | fl_choice()
+fl_clip(int, int, int, int)             | fl_push_clip(int x, int y, int w, int h)
+Fl_Group::focus(Fl_Widget *W)           | (Fl_Widget*) W->take_focus()
+Fl_Menu_Item::check()                   | Fl_Menu_Item::set()
+Fl_Menu_Item::checked() const           | int Fl_Menu_Item::value() const
+Fl_Menu_Item::uncheck()                 | Fl_Menu_Item::clear()
+Fl_Widget::color2() const               | Fl_Widget::selection_color() const
+Fl_Widget::color2(unsigned)             | Fl_Widget::selection_color(unsigned)
+
+
+
+\section migration_1_5_deprecated More Deprecated Methods and Functions
+
+All methods deprecated in <b> FLTK 1.4.x or earlier </b> are likely to be
+removed in the next minor FLTK version, presumably 1.6.0.
+
+Please update your code!
+
+The following list is currently incomplete and will be extended later.
+
+
+Symbol To Be Removed In The Next Minor Release         | Please Replace With ...
+-------------------------------------------------------|-------------------------
+void Fl_Window::icon(const void *ic)                   | void Fl_Window::icon(const Fl_RGB_Image *icon)
+const void *Fl_Window::icon() const                    | no replacement (was platform specific)
+&nbsp;                                                 | &nbsp;
+Fl_Tree::first_visible()                               | in 1.3.3 ABI
+Fl_Tree::first_visible_item()                          | ?
+Fl_Tree::item_clicked(Fl_Tree_Item *val)               | callback_item()
+Fl_Tree::item_clicked()                                | callback_item()
+Fl_Tree::last_visible()                                | last_visible_item()
+&nbsp;                                                 | &nbsp;
+Fl_Tree_Item::Fl_Tree_Item(const Fl_Tree_Prefs &prefs) | Fl_Tree_Item(Fl_Tree*)
+Fl_Tree_Item::next_displayed(Fl_Tree_Prefs &prefs)     | next_visible()
+Fl_Tree_Item::prev_displayed(Fl_Tree_Prefs &prefs)     | prev_visible()
+
+For details please refer to the documentation of FLTK 1.4 at
+https://www.fltk.org/doc-1.4/deprecated.html.
 
 
 \htmlonly