If -DPXR_BUILD_DOCUMENTATION=ON is applied during cmake configuration, but doxygen is not available, there will be a warning emitted as follows:
CMake Warning at CMakeLists.txt:76 (message):
Cannot run doc generation, doxygen not found.
The configuring and & generating process will be marked as "done"... however, this results in the pxr_toplevel_epilogue() not being invoked. The binaries will build and install but it will be missing, for example, the critical trampolining plugInfo.json at $USD_INSTALLATION/lib/usd/plugInfo.json.
It would be more helpful to either:
hard error during cmake configuration if doxygen is not available and documentation is requested.
with the soft warning, at least make sure pxr_toplevel_epilogue() is still run.
Steps to Reproduce
Run a CMake configure with -DPXR_BUILD_DOCUMENTATION=ON without doyxgen available in the environment.
There should be a lack of usd_plugInfo.json in the CMake build dir.
Description of Issue
If
-DPXR_BUILD_DOCUMENTATION=ON
is applied during cmake configuration, butdoxygen
is not available, there will be a warning emitted as follows:The configuring and & generating process will be marked as "done"... however, this results in the
pxr_toplevel_epilogue()
not being invoked. The binaries will build and install but it will be missing, for example, the critical trampoliningplugInfo.json
at$USD_INSTALLATION/lib/usd/plugInfo.json
.It would be more helpful to either:
doxygen
is not available and documentation is requested.pxr_toplevel_epilogue()
is still run.Steps to Reproduce
-DPXR_BUILD_DOCUMENTATION=ON
withoutdoyxgen
available in the environment.usd_plugInfo.json
in the CMake build dir.System Information (OS, Hardware)
Ubuntu-18.04
Package Versions
usd-20.02
Build Flags