CMakePP / CMinx

Generates API documentation for CMake functions and macros
https://cmakepp.github.io/CMinx/
Apache License 2.0
14 stars 5 forks source link

[BUG] Dangling doccomments result in a `mismatched input <EOF>` error #152

Closed AutonomicPerfectionist closed 1 year ago

AutonomicPerfectionist commented 1 year ago

Describe the bug Processing a CMake file that has a doccomment not attached to any other entity results in a mismatched input <EOF> error from Antlr.

Expected behavior Since a dangling doccomment is not considered "proper" syntax, how we should handle this is up for debate. At the very least, CMinx should not vomit a stacktrace in such a case. It should probably warn the user, and either ignore the comment or stick it in a simple text block in the RST.

Additional context Found after merging CMakePP/CMaize#102, during the Build-Documentation workflow.