'javadoc'看起来很像，使用解析器生成器？

Question

我将为我主要使用的语言创建一个javadoc look-a-like，但我想知道 - 为此使用解析器生成器是否值得？使用解析器生成器的主要思想是因为我可以使用可以导出的HTML代码的模板。如果需要，我也可以使用PDF模板。

谢谢，

William v.Doorn

Answer 1

如果要做的就是提取“Javadoc”注释，则不需要完整的解析器;毕竟，你只需要识别评论和正则表达式就可以了。

如果你想从代码中提取信息并使用它来扩充javadoc注释，你不仅需要解析器，还需要名称和类型解析。

您可以在Java Source Code Browser中看到组合解析，名称/类型解析和Javadoc注释提取的结果，这会产生Javadoc结果以及交叉引用到Javadocs中的完全超链接的源代码。

产生这个的机器是像ANTLR这样的概括。但是几乎没有必要使用代码模板来生成HTML本身;所有艰苦的工作都是在符号表中进行解析和事实收集。