Add setup for doxygen documentation

[Krishna-13-cyber]

Signed-off-by: [email protected] Krishna Narayanan

[vgvassilev]

Suggested change

	option(INTEROP_INCLUDE_DOCS "Generate build targets for the Cppinterop docs.")
	option(INTEROP_ENABLE_DOXYGEN "Use doxygen to generate Cppinterop interal API documentation.")
	option(INTEROP_ENABLE_SPHINX "Use sphinx to generage Cppinterop user documentation")
	option(INTEROP_INCLUDE_DOCS "Generate build targets for the CppInterOp docs.")
	option(INTEROP_ENABLE_DOXYGEN "Use doxygen to generate CppInterOp interal API documentation.")
	option(INTEROP_ENABLE_SPHINX "Use sphinx to generage CppInterOp user documentation")

[vgvassilev]

@Krishna-13-cyber ping.

[parth-07]

Why is this commented out?
And also, html_extra_path directory probably should not contain index.html file. Otherwise,
readthedocs will get confused which page should be used when visiting the website root.

[Krishna-13-cyber]

In my next patch to fix the issue of doxygen, I have added the html_extra_path main...Krishna-13-cyber:CppInterOp:CppInterOp-Doxygen-Implementation#diff-85933aa74a2d66c3e4dcdf7a9ad8397f5a7971080d34ef1108296a7c6b69e7e3R54 but still the issue persists .
The index.html for sphinx is being used as website root as we can see the output. The build directory of doxygen which consists of index.html is implicitly generated by default, so are you suggesting to modify the config to remove the index generation?

Current Status including the html_extra_path:
https://readthedocs.org/projects/cppinterop-docs/builds/21074694/

[parth-07]

I am suggesting to make the html_extra_path to something like, INTEROP_ROOT + '/build/docs'. This way we can
access internal documentation at ${WebsiteRoot}/doxygen/html, and index.html of sphinx and doxygen will not conflict with each other.