From bruen...@google.com on June 20, 2012 21:57:01

latest cygwin doxygen is 1.7.4 and we want 1.8.1 for best navbar (xref issue #629 and r1414 )

to build on cygwin:
install make, bison, flex, and libiconv

don't have "dot" but shouldn't need it.
it built but fails when using mixed path:

     Generating html/index.html
     CMake Error at D:/derek/dr/git/src/api/docs/CMake_rundoxygen.cmake:111 (message):
       *** d:/derek/extsw/doxygen/bin/doxygen.exe failed: ***

       Failed to open temporary file
       /d/derek/dr/git/build_docs/api/docs/D:/derek/dr/git/build_docs/api/docs/doxygen_objdb_2320.tmp

w/ unix path also fails:
CMake Error at D:/derek/dr/git/src/api/docs/CMake_doxyfile.cmake:176 (message):
/d/derek/extsw/doxygen/bin/doxygen.exe -u failed:

so I installed Windows binary build ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.8.1.1.windows.bin.zip and it works:

% cmake -G"$CMAKEGEN" -DDOXYGEN_EXECUTABLE:FILEPATH=d:/derek/install/doxygen.exe -DCMAKE_MAKE_PROGRAM:FILEPATH=MSBuild -DBUILD_SAMPLES=OFF -DCMAKE_INSTALL_PREFIX=../exports ../src
% cmake --build . --config Release --target api/docs/htmldocs -- /m

but, generated docs have the Usage...License pages as peers of top-level
Extensions, Deprecated, etc.!

ditto for 1.8.1

it's not that bad: I think I can live with it, but documenting the issue.

Original issue: http://code.google.com/p/dynamorio/issues/detail?id=815