lassade / c2z

C++ to Zig bindings and transpiler
102 stars 7 forks source link

Various improvements to docs generation, tested on Recast.h. #12

Closed Srekel closed 11 months ago

Srekel commented 11 months ago

This PR adds handling of various comment nodes. I've tested it on Recast.h and the style seems to match relatively well (newlines in the same places etc) but I believe there may be a few remaining discrepancies.

There may be more correct ways to handle some of these things, my solution did feel quite ad hoc and it was tricky to figure out exactly how the comment nodes relate to each other with ///'s at the start of the line and newlines after it, but it does seem to work.

The handled_inner_nodes thing is perhaps a bit unnecessarily complex but I figured it's nice to know which nodes remain untouched after both comment nodes and "real" nodes have been visited.

https://github.com/recastnavigation/recastnavigation/blob/main/Recast/Include/Recast.h