------------------------------------------------------------------------------
Installation of Free Magic (MSWindows0p9Free.zip)
[Build of all projects requires 178M of disk space]
------------------------------------------------------------------------------

The zip file has partial paths stored, so make sure you allow the unzip
utility to use these paths.  The directory structure relevant to building the
source code is given below.  A set of directories for the SDK that other
applications can use is created when you unzip the file.  A post-build step
copies the relevant files to these directories.

MagicSoftware
  FreeMagic
    Applications
      BuildApplications.dsw
    Source
      MagicFM.dsp
      MagicFMDLL.dsp
    Tools
      BuildTools.dsw
  Sdk
    Include (.h .inl .pkg files)
      Library
        Debug (static libraries)
        DebugDLL (dynamic link libraries)
        Release (static libraries)
        ReleaseDLL (dynamic link libraries)

Files *.h are header files, *.inl are files with (suggested) inline member
functions, and *.pkg are package files that provide collections of header
files that correspond to various submodules of the libraries (just for
convenience, not necessary to use the package files).


------------------------------------------------------------------------------
Command Line Build
------------------------------------------------------------------------------
Let ROOT be the directory to which the zip files have been unzipped.  The
top-level directory for the distribution will be ROOT/MagicSoftware.
Execute ROOT/MagicSoftware/SetupFree.exe (double-click from Windows Explorer
or run from command window).  A dialog box is launched that allows you to
specify which libraries, applications, or tools to build.  The setup program
compiles the source and creates the various libraries, applications, and
tools.  Full builds will take time, so be patient.  A full build of everything
requires 178M of disk space.


------------------------------------------------------------------------------
IDE Build
------------------------------------------------------------------------------
You can build all the projects from within Developer Studio.  The following
two projects should be built first before compiling the applications or tools.
    MagicFM.dsw
    MagicFMDLL.dsw
The application and tools projects are
    BuildApplications.dsw
    BuildTools.dsw    


------------------------------------------------------------------------------
Known Problems with the Installer
------------------------------------------------------------------------------
Using MSVC++ 6 SP3, the linker sometimes does not return to the shell to allow
the batch file to continue its build of other components.  A solution is to
terminate the comman window by clicking the close box in the upper right
corner.  Rerun SetupFree.exe multiple times until everything is finally built.
Under Windows 2000, you can keep an eye on the build with the Task Manager.
When the linker appears to hang, there are multiple "zombie" msdev.exe
processes running.  You can end those processes.  Once ended, the compile and
link proceeds normally.  A side effect of these problems is that Windows might
no longer recognize the file extensions h and cpp are associated with msdev.
Logging out, then logging back in seems to fix that problem.

I upgraded to MSVC++ 6 SP5 and have not yet had the linker hang, so perhaps
getting the current service pack is the best solution.  Or skip the setup and
build the projects from the IDE.
