This annotation is used to tag methods and parameters to give extra information
on how they handle
. SweetBlue strives to never return
if it doesn't have to, preferring things like
but in some situations it's unavoidable.
NOTE: This annotation is only used in places where the library authors have judged that
the API by itself may be unclear about its
handling for newcomers.
In general, if this annotation isn't used, you may assume