'javadoc'look-a-like，using parser generator？

Question

我打算爲我主要使用的語言創建一個javadoc，但我想知道是否值得使用解析器生成器？使用解析器生成器的主要想法是因爲我可以使用可以導出的HTML代碼的模板。如果需要，我也可以使用PDF模板。

感謝，

威廉五世多倫

Answer 1

如果你打算做的是提取「的Javadoc」的評論，你並不需要一個完整的解析器。畢竟，你只需要認識到評論和正則表達式可能會很好。

如果您想要從代碼中提取信息並使用它來擴充javadoc註釋，則不僅需要解析器，還需要名稱和類型解析。

您可以在Java Source Code Browser中看到合併解析，名稱/類型解析和Javadoc評論提取的結果，該結果生成Javadoc結果以及完全超鏈接的源代碼，並交叉引用到Javadoc中。

產生這種情況的機器是ANTLR之類的概念。但是很少需要使用代碼模板來生成HTML本身;所有的努力工作都是在符號表中進行解析和事實收集。