mirror of
https://github.com/audacity/wxWidgets.git
synced 2025-12-10 03:58:56 -06:00
202f62b4c4
Update bakefile configuration to include x64 configurations into MSVS 2005 and 2008 projects (2003 doesn't support building in 64 bits, 2010 and later are manually maintained and already have them) and rebake the projects. Closes #13675. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@76768 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
Ifacecheck utility
==================
1) INTRODUCTION
This utility compares the wxWidgets real interface contained in the "include"
hierarchy with the wxWidgets interface used for documentation purposes and
kept in the "interface" hierarchy.
Ifacecheck warns about incoherences (mainly wrong prototype signatures) and
can even correct them automatically. It uses the XML outputs of the gccxml utility
(see http://www.gccxml.org) and of the Doxygen utility (see http://www.doxygen.org)
to do the comparison.
It's explicitly designed for wxWidgets documentation needs and is probably of little
use for anything else than wxWidgets docs reviewing.
2) PREREQUISITES FOR USING IT
To use this utility you'll need at least:
- wxWidgets "include" and "interface" headers tree
- Doxygen installed
- Gccxml installed
3) HOW TO USE IT (on Linux)
First, create the doxygen XML:
> cd docs/doxygen
> ./regen.sh xml
> cd ../..
Next, create the gcc XML:
> ./configure # configure wxWidgets as you would do when building it
> cd utils/ifacecheck
> ./rungccxml.sh
> cd ../..
Last, build and run ifacecheck:
> cd utils/ifacecheck/src
> make
> make install
> cd ..
> ifacecheck -u wxapi-preproc.txt wxapi.xml ../../docs/doxygen/out/xml/index.xml >ifacecheck.log
Now you should have the log of the utility saved in 'ifacecheck.log'.
Its contents should be easy to interpret.
For more info about ifacecheck options just type:
> ifacecheck --help