search

unitsofmeasurement / unit-api

Units of Measurement API
http://unitsofmeasurement.github.io/unit-api/
Other
180 stars 42 forks source link

Use @API Guardian? #202

Closed keilw closed 4 years ago

keilw commented 4 years ago

In a future version, if it doesn't add too much extra payload to the JAR size we may use we may use @API Guardian here, too.

teobais commented 4 years ago

What is the rational behind tagging this as "deferred"?

desruisseaux commented 4 years ago

I can see its use in implementations, or temporarily in unit-api during development phase, but it seems a little bit surprising to declare e.g. an API as experimental in an interface published as a JCP standard. I think it may also be desirable to keep unit-api free of any runtime dependency. I would be more neutral if API was a build-time dependency only, but unfortunately it is declared with @Retention(RUNTIME) instead of @Retention(SOURCE).

keilw commented 4 years ago

That's why it is deferred to a possible future version.