search

jessevdk / cldoc

clang based documentation generator for C and C++
GNU General Public License v2.0
553 stars 59 forks source link

incremental document generation #82

Closed fanbin closed 9 years ago

fanbin commented 9 years ago

We tried to adopt cldoc on an existed project (~30k lines), but quickly lost confidence because cldoc kept asking us to correct the comments and make them compatible with cldoc's standards: she refused to generate any result unless we make every-piece-of-comment right. That work might cost us couple of weeks.

Maybe cldoc could have a 'nice and incremental' mode, in which she just parses those sources files that have compatible comments and ignore those that do not, so that we can gradually make our project compatible with cldoc's comment standard and keep seeing our progress during that process.

jessevdk commented 9 years ago

What exactly happens? cldoc should already be graceful in the case of malformed comments, and just report on them.

jessevdk commented 9 years ago

No further information has been provided, I'm closing this. Please feel free to reopen if the problem persists.