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

diff --git a/fluid/code.h b/fluid/code.h
new file mode 100644
index 000000000..00c6c8855
--- /dev/null
+++ b/fluid/code.h
@@ -0,0 +1,44 @@
+//
+// Code output 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_CODE_H
+#define _FLUID_CODE_H
+
+#include <FL/fl_attr.h>
+
+#include <stdarg.h>
+
+extern int indentation;
+extern int write_number;
+extern int write_sourceview;
+
+int is_id(char c);
+const char* unique_id(void* o, const char*, const char*, const char*);
+extern const char* indent();
+int write_declare(const char *, ...) __fl_attr((__format__ (__printf__, 1, 2)));
+void write_cstring(const char *,int length);
+void write_cstring(const char *);
+void write_cdata(const char *,int length);
+void vwrite_c(const char* format, va_list args);
+void write_c(const char*, ...) __fl_attr((__format__ (__printf__, 1, 2)));
+void write_cc(const char *, int, const char*, const char*);
+void write_h(const char*, ...) __fl_attr((__format__ (__printf__, 1, 2)));
+void write_hc(const char *, int, const char*, const char*);
+int write_code(const char *cfile, const char *hfile);
+int write_strings(const char *sfile);
+void write_public(int state); // writes pubic:/private: as needed
+
+#endif // _FLUID_CODE_H