[FLAPI-57] Adds javadoc comments to method via the .withMethod(...) method.

[FLAPI-113] Fixes method ordering issue, which was likely introduced with the StateClass rearch.
[FLAPI-20] generated classes are now created under subpackages. The result is a cleaner layout of the generated package, but does mean the entire directory should be copied instead of the single flat package (true already to some extent thanks to the support classes).
[FLAPI-20] Regenerated descriptors with subpackages enabled. Other classes refactored automatically by the IDE.
[FLAPI-49] Adds the ability to mark methods as deprecated. An optional
message can be provided as well, which will be used in the Javadoc string
of the @deprecated parameter.

Also refactors MethodOutline into a more generic MethodInfo, and finally hides min and max values behind property accessors.
[FLAPI-95] Fixes validation check which ensures that blocks with no last methods should be rejected. The problem was not in the validity check, but rather the recursion that it uses.