search

DynamoRIO / dynamorio

Dynamic Instrumentation Tool Platform
Other
2.63k stars 557 forks source link

doxygen 1.9.8 build failure on page_home\copydetails #6681

Closed derekbruening closed 6 months ago

derekbruening commented 7 months ago

doxygen 1.9.8 gives this error building the DR docs:

CMake Error at api/docs/CMake_rundoxygen.cmake:154 (message):
  *** doxygen failed: ***

  api/docs/home.dox:38: warning: @copybrief or
  @copydoc target 'page_home\copydetails' not found

  api/docs/home.dox:38: warning: @copybrief or
  @copydoc target 'page_home\copydetails' not found
derekbruening commented 7 months ago

I have a further error on my Mac, though it's the same 1.9.8 doxygen:

CMake Error at api/docs/CMake_rundoxygen.cmake:338 (message):
  Cannot find "page_user_docs" menu file

Indeed, there aren't any page_*.js files generated! Yet on another Linux machine with 1.9.8 those are there.

derekbruening commented 6 months ago

git blame points to this as the purpose of that part of the CMake code massaging the menu to have the order we want on dynamorio.org: "Moves DynamoRIO Extensions from API Reference into User Docs by moving from navtreedata.js to page_user_docs.js."

derekbruening commented 6 months ago

I believe all pieces here are now fixed. The docs now build on my Mac and Linux machines.