It seems that I can't comment, so I have to leave another answer.

@rzwitserloot - I like you're very thorough answer about why using existing "stuff" is confusing and difficult to implement.

I like to through out a suggestion though. On the simpler annotations that only generate one thing (NoArgs, AllArgs, and etc.) don't reuse existing annotations. Add a new parameter @NoArgsConstructor( javadoc=" My meaningful Description - blah, blah, blah, \n new line of more blah \n @Author Me \n @Version( 1.1.1)")

This would generate (literally, exactly the text provide except the comment code)

/** 
 * My meaningful Description - blah, blah, blah,
 * new line of more blah 
 * @Author Me
 * @Version( 1.1.1)
*/

Use only minimal interpretation, in my example only the "\n" for a new line and maybe add the tab "\t".

Another option would be to only allow actual Tabs and NewLines inside the quotes and then the only 'processing' would be to add the comment characters.

My justification for this answer is that JavaDoc seems to produce a lot of messages as WARNINGS. It is very easy to miss more obvious problems because they are lost in WARNINGS. I make an effort to clear out warnings so that I don't miss problems.

I understand this may be more difficult than I am making it out, but my goal is to get rid of the warnings so that I don't miss other important messages.

Thanks!

I haven't looked deeply into Lombok code, but this seems like a reasonable solution.