[antlr-interest] what does /** do?

[Benjamin Shropshire]

Loring Craymer wrote:
> No, it is not the norm--most systems just ignore javadoc comments.  Ter, however, decided to transmit the javadoc comments to the generated code, so ANTLR recognizes the javadoc comments in selected places that conform to stylistic conventions.  Comment preservation in language translators is somewhat of an art; the approach taken by ANTLR has the advantage of simplicity and utility, with the slight "drawback" that a javadoc placement style is enforced.
>
>   
fun. <joke>Why can't anything be simple. You'd think you should be able 
to put "/** type comments in the source are copied to the output and 
attached to the related function" and that would be that.</joke>