[geos-devel] [GEOS] #988: Doxygen error check with cmake build

[GEOS]

#988: Doxygen error check with cmake build
-----------------------------------+---------------------------
 Reporter:  nila                   |       Owner:  geos-devel@…
     Type:  enhancement            |      Status:  new
 Priority:  major                  |   Milestone:
Component:  Build/Install (cmake)  |     Version:  master
 Severity:  Unassigned             |  Resolution:
 Keywords:                         |
-----------------------------------+---------------------------

Comment (by dbaston):

 Thank you! I had started along these lines but hadn't finished.

 To ignore "not documented" errors I think we should set the appropriate
 flag in Doxyfile rather than grepping the output.

 It would be nice to understand the source of the "invalid tag" errors too
 ; maybe we can avoid those by specifying a required Doxygen verison.

 These changes would allow a simpler solution of just having Doxygen stop
 on error instead of parsing the log files.

 Opening a pull request at GitHub will test the changes against roughly 40
 platforms; however, documentation is only built on Linux. I will look at
 enabling Doxygen for OS X / Windows builds.

-- 
Ticket URL: <https://trac.osgeo.org/geos/ticket/988#comment:1>
GEOS <http://trac.osgeo.org/geos>
GEOS (Geometry Engine - Open Source) is a C++ port of the Java Topology Suite (JTS).