iLCSoft / Marlin

Modular Analysis and Reconstruction for the LINear Collider
GNU General Public License v3.0
11 stars 16 forks source link

DOC: new doxygen does not like html files #32

Closed andresailer closed 6 years ago

andresailer commented 6 years ago

newer versions of doxygen (1.8.8) are not treating unknown extensions, thus we rename overview.html to overview.txt See https://www.stack.nl/~dimitri/doxygen/manual/faq.html "My file [...] is not parsed anymore"

BEGINRELEASENOTES

ENDRELEASENOTES

rete commented 6 years ago

@andresailer : We should maybe set the INSTALL_DOC option to ON for TravisCI, just for validation and then switch it back to OFF before merging the pull request.

andresailer commented 6 years ago

The Ninja generator doesn't like the doc creation procedure

rete commented 6 years ago

Can you try with the standard Makefile generator and make install ? It should make the trick.

rete commented 6 years ago

Nice ! It seems that the overview.txt is correctly processed by doxygen.

andresailer commented 6 years ago

https://sailer.web.cern.ch/sailer/Marlin/html/index.html

andresailer commented 6 years ago

Is everyone happy with this now? There are a few more packages which include html files into doxygen that need to get the same treatment.

rete commented 6 years ago

Everybody is happy !