Add option to skip @Generated annotation

[mtf90]

This PR adds an additional annotation parameter to @GenerateEmbeddedDSL that allows to skip the @Generated annotation in the generated DSL class. The two main motivations behind this are:

• Allowing to build cross-version compatible JARs. Currently, if one uses the duzzt processor on JRE 8, the generated class will be annotated with @javax.annotation.Generated, an annotation that has been removed in JREs 11+. This forces end-users to include an additional dependency for newer JREs in order to use a product (e.g. AutomataLib/LearnLib) that uses duzzt.

• By providing said dependency, end-users may violate Oracle's binary code license, which states:

  F. JAVA TECHNOLOGY RESTRICTIONS. You may not create, modify, or change the behavior of, or authorize your licensees to create, modify, or change the behavior of, classes, interfaces, or subpackages that are in any way identified as "java", "javax", "sun", “oracle” or similar convention as specified by Oracle in any naming convention designation.

  Even though the @javax.annotation.Generated is officially part of JRE 8, adding javax annotations to environments where they are not present (JRE 11+) may be interpreted as adding behavior, which would then prevent end-users to use products (e.g. AutomataLib/LearnLib) in a binary distribution with Oracle's JVM.

This feature is fully backwards-compatible, as this additional functionality is disabled by default and hence behaves like the current/latest version.

[misberner]

Thanks! Will create a new release with this soon-ish

[mtf90]

Thanks for the quick response. No hurry, this is not a show-stopper for us, just something we should clean up in one of the next releases (cf. LearnLib/automatalib#33). Do you think you can also have a look at misberner/buildergen#1 while you're at it?

…

On Sun, Jul 14, 2019 at 06:41:38AM -0700, Malte Isberner wrote: Thanks! Will create a new release with this soon-ish -- You are receiving this because you authored the thread. Reply to this email directly or view it on GitHub: #6 (comment)