Update the JavaDoc generation

[TheMrMilchmann]

With this PR...

• more reliable @see and @since tag generation is added,
• JavaDoc lines will always begin with a star ("*"). (Note that this does include code blocks!), and
• less blank JavaDoc will be generated.

The changes have been made in order to enhance the readability and quality of generated documentation. However, this does come at the cost that code snippets may not be copied straight from code blocks any longer (what I consider bad practice anyways).

All differences in the generated code can seen here.

This also fixes a bug that sometimes caused @since tags to not be generated properly (current vs. updated).

(A piece of documentation on how commits should be titled would be nice. I hope that this is in compliance with the new format.)

[Spasi]

Good job @TheMrMilchmann, we needed these fixes.

This PR has been merged manually with 2dbfac3, c3e5ea3 and ec09a19. There are a couple more cases fixed and the code is closer to the original implementation, for performance reasons. It's still not as efficient as I'd like, but it's hard to do the necessary refactoring (NativeClass::convertDocumentation is the blocker).

A piece of documentation on how commits should be titled would be nice.

I'm currently evaluating Conventional Commits (with Angular convention's flexibility) in LWJGL and some other projects. Not going to use the SemVer automation, but I think it's a useful convention. Especially in LWJGL with the dozens of bindings, it makes it easier to quickly identify what each commit is about.

I'll post some guidelines if/when I make the decision to adopt it.