Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

improve extension API documentation and resolve some open questions #515

Merged
merged 1 commit into from
Aug 30, 2021

Commits on Aug 20, 2021

  1. improve extension API documentation and resolve some open questions

    - renamed/moved `AnnotationInfo.MEMBER_VALUE` to `AnnotationMember.VALUE`
    - replaced the phrase "component type" with "element type" when speaking
      about arrays, because JLS uses both and each has a different meaning
    - removed `ContextConfig`, custom context registration is now fully
      handled in `MetaAnnotations`
    - removed unnecessarily concrete language from `@SkipIfPortableExtensionPresent`
    - methods in the `Types` class now have more specific return types
    - implementations of `AnnotationInfo`, `AnnotationMember` and `AnnotationTarget`
      are now required to define `equals` and `hashCode`, and are explicitly
      not required to use a single object to represent a single construct
    - the `ClassInfo` declaration is now required to return annotations
      `@Inherited` from a superclass, per `@Inherited` spec and CDI spec
    - explicitly documented that `ClassInfo` doesn't provide access to nested
      classes or an enclosing class, and `PackageInfo` doesn't provide access
      to package members
    - corrected some language to distinguish between generic classes (before
      type argument application) and parameterized types (after type argument
      application)
    - specified meaning of `MethodInfo.name` and `returnType` for constructors,
      mirroring what reflection does (returning the declaring class)
    - defined how implicit bounds are represented in `TypeVariable`
      and `WildcardType`
    - removed `ObserverInfo.id()`
    - usage of `Optional` was eliminated everywhere
    - instead of "`void` type", we now always use "`void` pseudo-type"
    - added `@since 4.0` tags everywhere
    - changed `@link` tags to `@linkplain` if the link text isn't an identifier
    Ladicek committed Aug 20, 2021
    Configuration menu
    Copy the full SHA
    2d14e87 View commit details
    Browse the repository at this point in the history