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

diff --git a/fluid/file.h b/fluid/file.h
new file mode 100644
index 000000000..18b96492e
--- /dev/null
+++ b/fluid/file.h
@@ -0,0 +1,40 @@
+//
+// Fluid file routines 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_FILE_H
+#define _FLUID_FILE_H
+
+#include <FL/fl_attr.h>
+
+extern double read_version;
+extern int fdesign_flip;
+extern int fdesign_magic;
+
+void write_word(const char *);
+void write_string(const char *,...) __fl_attr((__format__ (__printf__, 1, 2)));
+void write_indent(int n);
+void write_open(int);
+void write_close(int n);
+
+void read_error(const char *format, ...);
+const char *read_word(int wantbrace = 0);
+
+int write_file(const char *, int selected_only = 0);
+
+int read_file(const char *, int merge);
+void read_fdesign();
+
+#endif // _FLUID_FILE_H