iaccessible2/buildinfo

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.

Groups: