fltk/ide
Albrecht Schlosser 2b6c2bc7af Make VisualC2008/2010 projects create FL/abi-version.h (STR #3249).
First step towards a hopefully clean creation of FL/abi-version.h for all
Windows (Visual Studio) and maybe also Xcode projects (if necessary) in
order to "simulate" configure and CMake methods to create this file.

I could only modify the VisualC2008 and VisualC2010 project files, because
I don't have VisualC6 and/or Xcode. Help needed...

To do for remaining <ide> directories (ide/VisualC6 and maybe ide/Xcode4):

 (1) Remove <ide>/FL folders including <ide>/FL/abi-version.h.
 (2) Add a Pre-Build event or equivalent on project 'fltk' for all
     potential build configurations (Debug, Release, ...)
 (3) Maybe add project dependencies to ensure that the Pre-Build event
     of project 'fltk' is executed before all other projects.

Notes:

 (a) Command line for Pre-Build events of VS2008/2010:
     "copy /Y $(SolutionDir)..\..\abi-version.ide $(SolutionDir)..\..\FL\abi-version.h"
     Something similar should work for VC6 as well.

 (b) While building the projects I found some wrong output settings in zlib
     projects. These have been fixed in this commit as well (unrelated).
     
 (c) .gitignore has been extended to ignore all intermediate build files
     of VS2008/VS2010 ide projects.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@11010 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2016-01-19 14:02:10 +00:00
..
VisualC6 Add copyright comments, improve comments, don't set FL_ABI_VERSION. 2015-07-13 18:17:33 +00:00
VisualC2008 Make VisualC2008/2010 projects create FL/abi-version.h (STR #3249). 2016-01-19 14:02:10 +00:00
VisualC2010 Make VisualC2008/2010 projects create FL/abi-version.h (STR #3249). 2016-01-19 14:02:10 +00:00
Xcode4 Mac OS: Enhanced the application bundle for the editor demo 2015-12-29 16:41:15 +00:00
README.IDE Changed Xcode-related date. 2015-03-22 07:38:05 +00:00

-------------------------------------------
   HOW TO USE THE FLTK IDE ENVIRONMENTS
-------------------------------------------

As for today, FLTK 1.3 officially supports 
the following integrated environments (1):

------------------------------------------------------------------------
distrib subdir 	|   supported products
------------------------------------------------------------------------
ide/VisualC6	|   Microsoft Visual C++ 6 and 2005 (2)
ide/VisualC2008	|   Microsoft Visual C++ 2008
ide/VisualC2010	|   Microsoft Visual C++ 2010 and later (3)
ide/Xcode4 	|   Apple Xcode 3.x and up (see ../README.OSX.txt)

Notes :
-------
(1) For *nix platforms based on the autoconf/configure/make toolchain,
    simply run autoconf, then the configure script on the root dir.
    Read the ./README file for more info.
(2) When first using the project file (ide/VisualC6/fltk.dsw) with
    VC++ 2005, you will be asked to convert the project to the newer
    format.
(3) When first using the project file (ide/VisualC2010/fltk.sln) with
    a later version of Visual C++ you may be asked to convert the project
    to the newer format.


Further notes about Microsoft IDE project files (December 2010):
------------------------------------------------------------------------

The FLTK team limits support to the last two releases of any major IDE.
For Visual Studio, this is currently VisualC 2008 and VisualC 2010. 
Earlier versions of Visual Studio can import the VisualC6 Project file
to generate a working Solution.

VisualC2008 and VisualC2010 Solutions were generated with the free 
Visual Studio Express edition of the corresponding version.


Further notes about Xcode IDE project files (March 2015):
------------------------------------------------------------------------

The FLTK Xcode project, FLTK.xcodeproj, is usable with versions 3 and 
upward of Xcode (even if it's in a directory called Xcode4 for 
historical reason). The Xcode developer environment is currently 
available at no cost from the App store.


Other IDE's and Platforms
------------------------------------------------------------------------

Code::Blocks supports FLTK project natively. Please compile and install 
FLTK using the Makefile system. Once installed, new FLTK projects 
can be generated using the Code::Blocks IDE.

Further IDE's can only be supported if a volunteer maintainer is found.
If you feel that your favourite IDE is missing from our list, we will
happily add your IDE files and ask you to keep them up to date.


Using CMake to generate IDE project files
------------------------------------------------------------------------

Other IDE files can likely be created using CMake and the provided
CMake files. However, as of Mar 2015 (FLTK 1.3.4) this is not yet fully
supported. The FLTK team can't guarantee the usability of any generated
IDE files.