Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 2422489f authored by Neil Fuller's avatar Neil Fuller
Browse files

Fix docs to be clearer and more maintainable 

The mention of P in the doc was unclear. Also, listing the specific
values allowed is a maintenance issue.

Test: None
Change-Id: I9c46eec353090ecd822f10a0a9e8433fa46246a0
parent 8a9a9ada

core/java/android/annotation/UnsupportedAppUsage.java

+3 −6
Original line number Diff line number Diff line
@@ -83,8 +83,9 @@ public @interface UnsupportedAppUsage { 
     * <p>Possible values are:

     * <ul>

     *     <li>

     *         {@link android.os.Build.VERSION_CODES#O} or {@link android.os.Build.VERSION_CODES#P},

     *         to limit access to apps targeting these SDKs (or earlier).

     *         An API level like {@link android.os.Build.VERSION_CODES#O} - in which case the API is

     *         available up to and including the specified release. Or, in other words, the API is

     *         blacklisted (unavailable) from the next API level from the one specified.

     *     </li>

     *     <li>

     *         absent (default value) - All apps can access this API, but doing so may result in
@@ -94,10 +95,6 @@ public @interface UnsupportedAppUsage { 
     *

     * </ul>

     *

     * Note, if this is set to {@link android.os.Build.VERSION_CODES#O}, apps targeting O

     * maintenance releases will also be allowed to use the API, and similarly for any future

     * maintenance releases of P.

     *

     * @return The maximum value for an apps targetSdkVersion in order to access this API.

     */

    int maxTargetSdk() default Integer.MAX_VALUE;