changeset 1969:b0a67ac65949

some doc/ updates
author corvid <corvid@lavabit.com>
date Tue, 19 Apr 2011 02:07:57 +0000
parents d80adb974879
children a529c15e35bd
files doc/Dillo.txt doc/dw-usage.doc doc/fltk-problems.doc doc/user_help.html
diffstat 4 files changed, 26 insertions(+), 42 deletions(-) [+]
line wrap: on
line diff
--- a/doc/Dillo.txt	Tue Apr 19 01:12:12 2011 +0000
+++ b/doc/Dillo.txt	Tue Apr 19 02:07:57 2011 +0000
@@ -23,7 +23,7 @@
 
    Dillo can be viewed as the sum of five main parts:
 
-   1.- Dillo Widget: A custom widget, FLTK2 based, that holds the
+   1.- Dillo Widget: A custom widget, FLTK-based, that holds the
 necessary data structures and mechanisms for graphical rendering.
 (Described in Dw*.txt, dw*.c files among the sources.)
 
--- a/doc/dw-usage.doc	Tue Apr 19 01:12:12 2011 +0000
+++ b/doc/dw-usage.doc	Tue Apr 19 02:07:57 2011 +0000
@@ -23,8 +23,8 @@
 First of all, the necessary \#include's:
 
 \code
-#include <fltk/Window.h>
-#include <fltk/run.h>
+#include <FL/Fl_Window.H>
+#include <FL/Fl.H>
 
 #include "dw/core.hh"
 #include "dw/fltkcore.hh"
@@ -54,7 +54,7 @@
 For the view, we first need a FLTK window:
 
 \code
-   fltk::Window *window = new fltk::Window(200, 300, "Dw Example");
+   Fl_Window *window = new Fl_Window(200, 300, "Dw Example");
    window->begin();
 \endcode
 
@@ -101,9 +101,9 @@
 
 \code
    styleAttrs.color =
-      dw::core::style::Color::createSimple (layout, 0x000000);
+      dw::core::style::Color::create (layout, 0x000000);
    styleAttrs.backgroundColor =
-      dw::core::style::Color::createSimple (layout, 0xffffff);
+      dw::core::style::Color::create (layout, 0xffffff);
 \endcode
 
 Finally, the style for the widget is created:
@@ -193,7 +193,7 @@
 \code
    window->resizable(viewport);
    window->show();
-   int errorCode = fltk::run();
+   int errorCode = Fl::run();
 \endcode
 
 For cleaning up, it is sufficient to destroy the layout:
--- a/doc/fltk-problems.doc	Tue Apr 19 01:12:12 2011 +0000
+++ b/doc/fltk-problems.doc	Tue Apr 19 02:07:57 2011 +0000
@@ -26,10 +26,8 @@
 <li> There is the problem, that fltk::font always returns a font, the
      required one, or a replacements. The latter is not wanted in all
      cases, e.g. when several fonts are tested. Perhaps, this could be
-     solved by searching in the font list.
-
-<li> In dw::fltk::FltkFont::FltkFont, fltk::measure does not seem to work
-     for the calculation of dw::core::style::Font::xHeight.
+     solved by searching in the font list. <i>[This was true of fltk2.
+     What is the state of font handling now with fltk-1.3?]</i>
 
 <li> Distinction between italics and oblique would be nice
      (dw::fltk::FltkFont::FltkFont).
@@ -38,7 +36,7 @@
 
 <h2>dw::fltk::ui::FltkCheckButtonResource</h2>
 
-Groups of fltk::RadioButton must be added to one fltk::Group, which is
+Groups of Fl_Radio_Button must be added to one Fl_Group, which is
 not possible in this context. There are two alternatives:
 
 <ol>
@@ -58,7 +56,7 @@
 
 <h2>dw::fltk::ui::ComplexButton</h2>
 
-Unfortunately, FLTK does not provide a button with Group as parent, so
+Unfortunately, FLTK does not provide a button with Fl_Group as parent, so
 that children may be added to the button. dw::fltk::ui::ComplexButton does
 exactly this, and is, in an ugly way, a modified copy of the FLTK
 button.
@@ -70,7 +68,7 @@
 the FLTK source:
 
 <ol>
-<li> Copy fltk/Button.h from FLTK to dw/fltkcomplexbutton.hh and
+<li> Copy Fl_Button.H from FLTK to dw/fltkcomplexbutton.hh and
      src/Button.cxx to dw/fltkcomplexbutton.cc.
 
 <li> In both files, rename "Button" to "ComplexButton". Automatic replacing
@@ -120,17 +118,15 @@
 at the end. Most important, the base class is changed:
 
 \code
--#ifndef fltk_Widget_h
--#include "Widget.h"
--#endif
-+#include <fltk/Group.h>
+-#include "FL/Fl_Widget.H"
++#include <FL/Fl_Group.H>
 \endcode
 
 and
 
 \code
--class FL_API ComplexButton : public Widget {
-+class ComplexButton: public ::fltk::Group
+-class FL_API ComplexButton : public Fl_Widget {
++class ComplexButton: public Fl_Group
 +{
 \endcode
 
@@ -148,12 +144,10 @@
 
 \code
 
- #include <fltk/events.h>
- #include <fltk/damage.h>
--#include <fltk/ComplexButton.h> // <fltk/Button.h> formerly
- #include <fltk/Group.h>
- #include <fltk/Box.h>
- #include <stdlib.h>
+ #include <FL/Fl.H>
+-#include <FL/ComplexButton.h> // <FL/Fl_Button.H> formerly
+ #include <FL/Fl_Group.H>
+ #include <FL/Fl_Window.H>
 +
 +#include "fltkcomplexbutton.hh"
 \endcode
@@ -162,33 +156,23 @@
 
 \code
 +using namespace dw::fltk::ui;
- using namespace fltk;
 \endcode
 
-Since the base class is now Group, the constructor must be changed:
+Since the base class is now Fl_Group, the constructor must be changed:
 
 \code
--ComplexButton::ComplexButton(int x,int y,int w,int h, const char *l) : Widget(x,y,w,h,l) {
+-ComplexButton::ComplexButton(int x,int y,int w,int h, const char *l) : Fl_Widget(x,y,w,h,l) {
 +ComplexButton::ComplexButton(int x,int y,int w,int h, const char *l) :
-+   Group(x,y,w,h,l)
++   Fl_Group(x,y,w,h,l)
 +{
 \endcode
 
-At the end of the constructor,
-
-\code
-+  type (NORMAL);
- }
-\endcode
-
-must be added (I've forgotten, what this is for).
-
 Finally, the button must draw its children (end of
 dw::fltk::ui::ComplexButton::draw()):
 
 \code
 +
-+  for (int i = 0; i < children (); i++)
++  for (int i = children () - 1; i >= 0; i--)
 +     draw_child (*child (i));
  }
 \endcode
--- a/doc/user_help.html	Tue Apr 19 01:12:12 2011 +0000
+++ b/doc/user_help.html	Tue Apr 19 02:07:57 2011 +0000
@@ -9,7 +9,7 @@
 <body bgcolor='#778899' text='#000000'>
 
   <table bgcolor="#70a0c0" border="1" cellpadding="5">
-   <tr><td><h1>Help for Dillo 2.2</h1>
+   <tr><td><h1>Help for Dillo 3.0</h1>
   </table>
   <p>
   <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=5>
@@ -84,7 +84,7 @@
     <tr><td BGCOLOR="#70a0c0">
     <p>
     Downloads are made using <b><font color="#5040a0">wget</font></b>
-    with a FLTK2-based GUI wrapper, through the Dillo plugin (dpi) framework.
+    with a FLTK-based GUI wrapper, through the Dillo plugin (dpi) framework.
     If you close the browser window, downloads will continue.
     <p>
     </td></tr>