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, 118 insertions, 0 deletions

diff --git a/fluid/fluid.h b/fluid/fluid.h
new file mode 100644
index 000000000..e2370359f
--- /dev/null
+++ b/fluid/fluid.h
@@ -0,0 +1,118 @@
+//
+// FLUID main entry for the Fast Light Tool Kit (FLTK).
+//
+// Copyright 1998-2021 by Bill Spitzak and others.
+//
+// This library is free software. Distribution and use rights are outlined in
+// the file "COPYING" which should have been included with this file.  If this
+// file is missing or damaged, see the license at:
+//
+//     https://www.fltk.org/COPYING.php
+//
+// Please see the following page on how to report bugs and issues:
+//
+//     https://www.fltk.org/bugs.php
+//
+
+#ifndef _FLUID_FLUID_H
+#define _FLUID_FLUID_H
+
+#include <FL/filename.H>
+#include <FL/Fl_Preferences.H>
+#include <FL/Fl_Menu_Item.H>
+
+#define BROWSERWIDTH 300
+#define BROWSERHEIGHT 500
+#define WINWIDTH 300
+#define MENUHEIGHT 25
+#define WINHEIGHT (BROWSERHEIGHT+MENUHEIGHT)
+
+class Fl_Double_Window;
+class Fl_Window;
+class Fl_Menu_Bar;
+class Fl_Type;
+class Fl_Choice;
+class Fl_Button;
+
+extern int force_parent;
+
+extern Fl_Preferences fluid_prefs;
+extern Fl_Menu_Item Main_Menu[];
+extern Fl_Menu_Bar *main_menubar;
+extern Fl_Window *main_window;
+
+extern int gridx;
+extern int gridy;
+extern int snap;
+extern int show_guides;
+extern int show_comments;
+
+extern int G_use_external_editor;
+extern int G_debug;
+extern char G_external_editor_command[512];
+
+extern int reading_file;
+
+// File history info...
+extern char absolute_history[10][FL_PATH_MAX];
+extern char relative_history[10][FL_PATH_MAX];
+extern void load_history();
+extern void update_history(const char *);
+
+extern Fl_Menu_Item *save_item;
+extern Fl_Menu_Item *history_item;
+extern Fl_Menu_Item *widgetbin_item;
+extern Fl_Menu_Item *sourceview_item;
+
+extern int modflag;
+
+extern void goto_source_dir();
+extern void leave_source_dir();
+
+extern int update_file;            // fluid -u
+extern int compile_file;           // fluid -c
+extern int compile_strings;        // fluic -cs
+extern int batch_mode;
+
+extern int header_file_set;
+extern int code_file_set;
+extern const char* header_file_name;
+extern const char* code_file_name;
+
+extern int i18n_type;
+extern const char* i18n_include;
+extern const char* i18n_function;
+extern const char* i18n_file;
+extern const char* i18n_set;;
+extern char i18n_program[FL_PATH_MAX];
+
+extern int pasteoffset;
+
+// ---- public functions
+
+extern void set_filename(const char *c);
+extern void set_modflag(int mf);
+
+// ---- public callback functions
+
+extern void save_cb(Fl_Widget *, void *v);
+extern void save_template_cb(Fl_Widget *, void *);
+extern void revert_cb(Fl_Widget *,void *);
+extern void exit_cb(Fl_Widget *,void *);
+
+#ifdef __APPLE__
+extern void apple_open_cb(const char *c);
+#endif // __APPLE__
+
+extern void open_cb(Fl_Widget *, void *v);
+extern void open_history_cb(Fl_Widget *, void *v);
+extern void new_cb(Fl_Widget *, void *v);
+extern void new_from_template_cb(Fl_Widget *w, void *v);
+
+extern int write_code_files();
+extern void write_strings_cb(Fl_Widget *, void *);
+extern void align_widget_cb(Fl_Widget *, long);
+extern void widget_size_cb(Fl_Widget *, long);
+extern void toggle_widgetbin_cb(Fl_Widget *, void *);
+
+#endif // _FLUID_FLUID_H