Fluid: restructuring and commenting.

tl;dr : making Fluid maintainable, no changes in code execution and logic.

This is a pretty extensive restructuring of the Fluid source tree.
It was neccessary because source and header files were getting
much too big to handle. Many source files had no header, and many
headers declared functions that were in diffrent source files.

Reorganized much of the include statements.
Added comments to some of the files.
Added Doxygen configuration file for standalone Fluid docs.

Tested everything by rebuilding Fluid .fl designs with the resorted
version of Fluid.

1 files changed, 90 insertions, 1 deletions

diff --git a/fluid/Fl_Widget_Type.h b/fluid/Fl_Widget_Type.h
index ab33f4e10..6d39fb9f4 100644
--- a/fluid/Fl_Widget_Type.h
+++ b/fluid/Fl_Widget_Type.h
@@ -18,10 +18,99 @@
 //     https://www.fltk.org/bugs.php
 //
 
+#ifndef _FLUID_FL_WIDGET_TYPE_H
+#define _FLUID_FL_WIDGET_TYPE_H
+
 #include "Fl_Type.h"
 
-struct Fl_Menu_Item;
+#define NUM_EXTRA_CODE 4
+
+class Fl_Widget_Type;
 class Fluid_Image;
 
 extern void* const LOAD;
 extern Fl_Widget_Type *current_widget; // one of the selected ones
+
+extern const char* subclassname(Fl_Type* l);
+extern int is_name(const char *c);
+void selection_changed(Fl_Type* new_current);
+Fl_Type *sort(Fl_Type *parent);
+void comment_cb(class Fl_Text_Editor* i, void *v);
+
+class Fl_Widget_Type : public Fl_Type {
+  virtual Fl_Widget *widget(int,int,int,int) = 0;
+  virtual Fl_Widget_Type *_make() = 0; // virtual constructor
+  virtual void setlabel(const char *);
+
+  const char *extra_code_[NUM_EXTRA_CODE];
+  const char *subclass_;
+  const char *tooltip_;
+  const char *image_name_;
+  const char *inactive_name_;
+  uchar hotspot_;
+
+protected:
+
+  void write_static();
+  void write_code1();
+  void write_widget_code();
+  void write_extra_code();
+  void write_block_close();
+  void write_code2();
+  void write_color(const char*, Fl_Color);
+  Fl_Widget *live_widget;
+
+public:
+  static int default_size;
+
+  const char *xclass; // junk string, used for shortcut
+  Fl_Widget *o;
+  int public_;
+
+  Fluid_Image *image;
+  void setimage(Fluid_Image *);
+  Fluid_Image *inactive;
+  void setinactive(Fluid_Image *);
+
+  Fl_Widget_Type();
+  Fl_Type *make();
+  void open();
+
+  const char *extra_code(int n) const {return extra_code_[n];}
+  void extra_code(int n,const char *);
+  const char *subclass() const {return subclass_;}
+  void subclass(const char *);
+  const char *tooltip() const {return tooltip_;}
+  void tooltip(const char *);
+  const char *image_name() const {return image_name_;}
+  void image_name(const char *);
+  const char *inactive_name() const {return inactive_name_;}
+  void inactive_name(const char *);
+  uchar hotspot() const {return hotspot_;}
+  void hotspot(uchar v) {hotspot_ = v;}
+  uchar resizable() const;
+  void resizable(uchar v);
+
+  virtual int textstuff(int what, Fl_Font &, int &, Fl_Color &);
+  virtual Fl_Menu_Item *subtypes();
+
+  virtual int is_widget() const;
+  virtual int is_public() const;
+
+  virtual void write_properties();
+  virtual void read_property(const char *);
+  virtual int read_fdesign(const char*, const char*);
+
+  virtual Fl_Widget *enter_live_mode(int top=0);
+  virtual void leave_live_mode();
+  virtual void copy_properties();
+
+  virtual void ideal_size(int &w, int &h);
+  virtual void ideal_spacing(int &x, int &y);
+
+  ~Fl_Widget_Type();
+  void redraw();
+};
+
+
+#endif // _FLUID_FL_WIDGET_TYPE_H