After you check the IA2 project files out using BZR, this file can be used to understand how to build the IA2 docs, a merged IDL file, and a zip file containing the docs and IDL files.

• The directory tree…
  • ia2 contains:
    • buildapi.sh: the build script (need cygwin bash shell interpreter installed)
    • doxygen.conf: the doxygen config file
    • a merged IDL file with all the IDL concatenated together
    • a zip file containing IDL and doxygen output
    • an api directory which contains the IDL
    • a docs directory which contains the doxygen generated output
    • an IDL-Test directory which contains Visual Studio files for testing:
      • IA2 IDL Test.dsp/dsw, IA2 Merged IDL Test.dsp, StdAfx.cpp/h
• The build procedure
  • CD to the ia2 directory
  • sh buildapi.sh >sh.out
  • notepad sh.out (to check for errors)
  • the doxgen generated files, merged idl file, and the zip file will be built
  • CD to the ia2\IDL-Test directory
  • activate the dsw file
  • There are two projects, one for the individual idl files, one for the merged idl file
  • Build, Batch Build, Choose the non-merged IDL project
  • Fix any errors, save the fixes, and rebuild the project.
  • If there were errors, rebuild the merged file by rerunning buildapi.sh
  • Build, Batch Build, Choose the merged IDL project
  • Fix any errors in the original source IDLs or buildapi.sh that caused the problem
  • Rerun the builapi.sh build script.

Note: Don't fix errors in the merged file; fix them in the correct source file.