I want to work on fixing the Detection of ArUco Markers tutorial in this GitHub issue. I've made contributions to opencv and opencv_contrib so I'm familiar with building opencv and making pull requests. But now I'm running into problems trying to build the documentation and tutorials. I have Doxygen installed (via Homebrew) and I followed the instructions at Writing documentation for OpenCV.
When I run make doxygen
all of the copying…
steps seem to complete successfully, but at the Generate Doxygen documentation
step I get a large number "unable to resolve reference" of warnings. Here's an excerpt:
/Users/steve/Documents/GitHub/ssteve-opencv/build/doc/contrib_tutorials.markdown:3: warning: unable to resolve reference to 'tutorial_table_of_content_aruco' for \ref command
/Users/steve/Documents/GitHub/ssteve-opencv/build/doc/contrib_tutorials.markdown:4: warning: unable to resolve reference to 'tutorial_table_of_content_bgsegm' for \ref command
/Users/steve/Documents/GitHub/ssteve-opencv/build/doc/contrib_tutorials.markdown:5: warning: unable to resolve reference to 'tutorial_table_of_content_retina' for \ref command
/Users/steve/Documents/GitHub/ssteve-opencv/build/doc/contrib_tutorials.markdown:6: warning: unable to resolve reference to 'tutorial_omnidir_calib_main' for \ref command
/Users/steve/Documents/GitHub/ssteve-opencv/build/doc/contrib_tutorials.markdown:7: warning: unable to resolve reference to 'tutorial_multi_camera_main' for \ref command
The build/doc/doxygen/html
directory is created and includes index.html
and many other files, but the links to the modules haven't been created. Are there more steps to building the documentation and tutorials than are included at Writing documentation for OpenCV?