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, 15 insertions, 21 deletions

diff --git a/fluid/CodeEditor.h b/fluid/CodeEditor.h
index bf4b7b499..d30f1b680 100644
--- a/fluid/CodeEditor.h
+++ b/fluid/CodeEditor.h
@@ -1,7 +1,8 @@
 //
 // Code editor widget for the Fast Light Tool Kit (FLTK).
+// Syntax highlighting rewritten by erco@seriss.com 09/15/20.
 //
-// Copyright 1998-2020 by Bill Spitzak and others.
+// 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
@@ -21,51 +22,44 @@
 // Include necessary headers...
 //
 
+#include "StyleParse.h"
+
+#include <FL/Fl.H>
+#include <FL/Fl_Text_Buffer.H>
+#include <FL/Fl_Text_Editor.H>
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 #include <ctype.h>
-#include <FL/Fl.H>
-#include <FL/Fl_Text_Buffer.H>
-#include <FL/Fl_Text_Editor.H>
-#include "StyleParse.h"
+
+// ---- CodeEditor declaration
 
 class CodeEditor : public Fl_Text_Editor {
   friend class StyleParse;
 
   static Fl_Text_Display::Style_Table_Entry styletable[];
-
-  // 'style_parse()' - Parse text and produce style data.
   static void style_parse(const char *tbuff, char *sbuff, int len, char style);
-
-  // 'style_unfinished_cb()' - Update unfinished styles.
   static void style_unfinished_cb(int, void*);
-
-  // 'style_update()' - Update the style buffer...
   static void style_update(int pos, int nInserted, int nDeleted,
                            int /*nRestyled*/, const char * /*deletedText*/,
                            void *cbArg);
-
   static int auto_indent(int, CodeEditor* e);
 
-  public:
-
+public:
   CodeEditor(int X, int Y, int W, int H, const char *L=0);
   ~CodeEditor();
   int top_line() { return get_absolute_top_line_number(); }
-
-  // attempt to make the fluid code editor widget honour textsize setting
   void textsize(Fl_Fontsize s);
 };
 
-class CodeViewer : public CodeEditor {
-
-  public:
+// ---- CodeViewer declaration
 
+class CodeViewer : public CodeEditor {
+public:
   CodeViewer(int X, int Y, int W, int H, const char *L=0);
 
-  protected:
-
+protected:
   int handle(int ev) { return Fl_Text_Display::handle(ev); }
   void draw();
 };