Make FL_ABI_VERSION configurable (STR #3161).

This commit adds the configure option --with-abiversion and the CMake option
OPTION_ABI_VERSION. Both options can be set e.g. to 10304 to build with
FL_ABI_VERSION = 10304 (FLTK 1.3.4).

For IDE builds there are new files ide/<IDE-NAME>/FL/abi-version.h that
can be edited to change the ABI version before the FLTK lib is built.
Note that this file MUST be copied to the include/FL directory if the
IDE-built library is to be installed.

The default is FL_ABI_VERSION = FL_MAJOR*10000 + FL_MINOR*100 + 0, i.e.
10300 for all FLTK 1.3.x versions to keep binary compatibility (ABI).

Todo: more tests and more documentation.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10786 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

4 files changed, 124 insertions, 0 deletions

diff --git a/ide/VisualC2008/FL/abi-version.h b/ide/VisualC2008/FL/abi-version.h
new file mode 100644
index 000000000..a46603d6e
--- /dev/null
+++ b/ide/VisualC2008/FL/abi-version.h
@@ -0,0 +1,31 @@
+/*
+  DO NOT EDIT - This file must be configured BEFORE building FLTK !
+*/
+
+/*
+  ============================================================================
+  Important note to IDE users:
+  ============================================================================
+
+  This file *may* be edited *before* building FLTK with your IDE project,
+  i.e. in /path/to/fltk/ide/<your-ide>/FL/abi-version.h:
+
+    (1) Define FL_ABI_VERSION as described below.
+    (2) Rebuild the entire FLTK library.
+    (3) Optional: install files as usual including THIS file.
+
+  DO NOT edit this file after building the FLTK library, i.e. when this
+  file is already installed in a (system) directory used to build your
+  programs.
+
+  Editing this file w/o rebuilding the entire FLTK library will change
+  the ABI and thus render your programs unusable - they may crash or
+  show other unpredictable errors. You have been warned!
+
+  ============================================================================
+  End of important note to IDE users.
+  ============================================================================
+
+/* define FL_ABI_VERSION as 10x0y for FLTK ABI version 1.x.y */
+
+#define FL_ABI_VERSION 10300
diff --git a/ide/VisualC2010/FL/abi-version.h b/ide/VisualC2010/FL/abi-version.h
new file mode 100644
index 000000000..a46603d6e
--- /dev/null
+++ b/ide/VisualC2010/FL/abi-version.h
@@ -0,0 +1,31 @@
+/*
+  DO NOT EDIT - This file must be configured BEFORE building FLTK !
+*/
+
+/*
+  ============================================================================
+  Important note to IDE users:
+  ============================================================================
+
+  This file *may* be edited *before* building FLTK with your IDE project,
+  i.e. in /path/to/fltk/ide/<your-ide>/FL/abi-version.h:
+
+    (1) Define FL_ABI_VERSION as described below.
+    (2) Rebuild the entire FLTK library.
+    (3) Optional: install files as usual including THIS file.
+
+  DO NOT edit this file after building the FLTK library, i.e. when this
+  file is already installed in a (system) directory used to build your
+  programs.
+
+  Editing this file w/o rebuilding the entire FLTK library will change
+  the ABI and thus render your programs unusable - they may crash or
+  show other unpredictable errors. You have been warned!
+
+  ============================================================================
+  End of important note to IDE users.
+  ============================================================================
+
+/* define FL_ABI_VERSION as 10x0y for FLTK ABI version 1.x.y */
+
+#define FL_ABI_VERSION 10300
diff --git a/ide/VisualC6/FL/abi-version.h b/ide/VisualC6/FL/abi-version.h
new file mode 100644
index 000000000..a46603d6e
--- /dev/null
+++ b/ide/VisualC6/FL/abi-version.h
@@ -0,0 +1,31 @@
+/*
+  DO NOT EDIT - This file must be configured BEFORE building FLTK !
+*/
+
+/*
+  ============================================================================
+  Important note to IDE users:
+  ============================================================================
+
+  This file *may* be edited *before* building FLTK with your IDE project,
+  i.e. in /path/to/fltk/ide/<your-ide>/FL/abi-version.h:
+
+    (1) Define FL_ABI_VERSION as described below.
+    (2) Rebuild the entire FLTK library.
+    (3) Optional: install files as usual including THIS file.
+
+  DO NOT edit this file after building the FLTK library, i.e. when this
+  file is already installed in a (system) directory used to build your
+  programs.
+
+  Editing this file w/o rebuilding the entire FLTK library will change
+  the ABI and thus render your programs unusable - they may crash or
+  show other unpredictable errors. You have been warned!
+
+  ============================================================================
+  End of important note to IDE users.
+  ============================================================================
+
+/* define FL_ABI_VERSION as 10x0y for FLTK ABI version 1.x.y */
+
+#define FL_ABI_VERSION 10300
diff --git a/ide/Xcode4/FL/abi-version.h b/ide/Xcode4/FL/abi-version.h
new file mode 100644
index 000000000..a46603d6e
--- /dev/null
+++ b/ide/Xcode4/FL/abi-version.h
@@ -0,0 +1,31 @@
+/*
+  DO NOT EDIT - This file must be configured BEFORE building FLTK !
+*/
+
+/*
+  ============================================================================
+  Important note to IDE users:
+  ============================================================================
+
+  This file *may* be edited *before* building FLTK with your IDE project,
+  i.e. in /path/to/fltk/ide/<your-ide>/FL/abi-version.h:
+
+    (1) Define FL_ABI_VERSION as described below.
+    (2) Rebuild the entire FLTK library.
+    (3) Optional: install files as usual including THIS file.
+
+  DO NOT edit this file after building the FLTK library, i.e. when this
+  file is already installed in a (system) directory used to build your
+  programs.
+
+  Editing this file w/o rebuilding the entire FLTK library will change
+  the ABI and thus render your programs unusable - they may crash or
+  show other unpredictable errors. You have been warned!
+
+  ============================================================================
+  End of important note to IDE users.
+  ============================================================================
+
+/* define FL_ABI_VERSION as 10x0y for FLTK ABI version 1.x.y */
+
+#define FL_ABI_VERSION 10300