Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix broken @see tags in public documentation.

Browse Source 
These were previously being suppressed by doclava but with this change,
all failures are fixed and the suppression logic has been removed.

To fix the issues, there were a few possible changes made:
- broken reference to a public API (such as incorrect parameters): fixed
- unnecessary @link inside an @see tag: fixed
- @see referring to an @hide or @SystemApi: reference removed
- broken references to inner class constructors
 - worked around by fully qualifying the constructor

Bug: 6963924
Test: make doc-comment-check-docs
Exempt-From-Owner-Approval: cherry-picked from master
Change-Id: Ifbdce2de96cdffa560bd90f549fa7184d1f9af85
Merged-In: Ifbdce2de96cdffa560bd90f549fa7184d1f9af85
(cherry picked from commit e0624c7a40)
This commit is contained in:
Andrew Sapperstein
2020-04-28 12:29:20 -07:00
parent bf8d4b4480
commit 8fe35e5f21
42 changed files with 55 additions and 106 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
apex/blobstore/framework/java/android/app/blob/BlobStoreManager.java
View File

@@ -307,8 +307,8 @@ public class BlobStoreManager {
* {@link #getRemainingLeaseQuotaBytes()} before trying to
* acquire a lease.
*
* @see {@link #acquireLease(BlobHandle, int)}
* @see {@link #acquireLease(BlobHandle, CharSequence)}
* @see #acquireLease(BlobHandle, int)
* @see #acquireLease(BlobHandle, CharSequence)
*/
public void acquireLease(@NonNull BlobHandle blobHandle, @IdRes int descriptionResId,
@CurrentTimeMillisLong long leaseExpiryTimeMillis) throws IOException {
@@ -367,8 +367,8 @@ public class BlobStoreManager {
* {@link #getRemainingLeaseQuotaBytes()} before trying to
* acquire a lease.
*
* @see {@link #acquireLease(BlobHandle, int, long)}
* @see {@link #acquireLease(BlobHandle, CharSequence)}
* @see #acquireLease(BlobHandle, int, long)
* @see #acquireLease(BlobHandle, CharSequence)
*/
public void acquireLease(@NonNull BlobHandle blobHandle, @NonNull CharSequence description,
@CurrentTimeMillisLong long leaseExpiryTimeMillis) throws IOException {
@@ -420,8 +420,8 @@ public class BlobStoreManager {
* {@link #getRemainingLeaseQuotaBytes()} before trying to
* acquire a lease.
*
* @see {@link #acquireLease(BlobHandle, int, long)}
* @see {@link #acquireLease(BlobHandle, CharSequence, long)}
* @see #acquireLease(BlobHandle, int, long)
* @see #acquireLease(BlobHandle, CharSequence, long)
*/
public void acquireLease(@NonNull BlobHandle blobHandle, @IdRes int descriptionResId)
throws IOException {
@@ -467,8 +467,8 @@ public class BlobStoreManager {
* {@link #getRemainingLeaseQuotaBytes()} before trying to
* acquire a lease.
*
* @see {@link #acquireLease(BlobHandle, int)}
* @see {@link #acquireLease(BlobHandle, CharSequence, long)}
* @see #acquireLease(BlobHandle, int)
* @see #acquireLease(BlobHandle, CharSequence, long)
*/
public void acquireLease(@NonNull BlobHandle blobHandle, @NonNull CharSequence description)
throws IOException {

1
core/java/android/app/Activity.java
View File

@@ -3743,7 +3743,6 @@ public class Activity extends ContextThemeWrapper
* To receive this callback, you must return true from onKeyDown for the current
* event stream.
*
* @see KeyEvent.Callback#onKeyLongPress()
* @see KeyEvent.Callback#onKeyLongPress(int, KeyEvent)
*/
public boolean onKeyLongPress(int keyCode, KeyEvent event) {

3
core/java/android/app/ActivityManager.java
View File

@@ -2450,8 +2450,7 @@ public class ActivityManager {
* has access to it.
*
* @see ActivityOptions#setLaunchDisplayId(int)
* @see android.view.Display.FLAG_PRIVATE
* @see android.view.Display.TYPE_VIRTUAL
* @see android.view.Display#FLAG_PRIVATE
*
* @param context Source context, from which an activity will be started.
* @param displayId Target display id.

6
core/java/android/app/AppOpsManager.java
View File

@@ -6858,10 +6858,7 @@ public class AppOpsManager {
* @param ops The operations to watch.
* @param callback Where to report changes.
*
* @see #isOperationActive
* @see #stopWatchingActive
* @see #startOp(int, int, String, boolean, String, String)
* @see #finishOp(int, int, String, String)
*/
// TODO: Uncomment below annotation once b/73559440 is fixed
// @RequiresPermission(value=Manifest.permission.WATCH_APPOPS, conditional=true)
@@ -6909,10 +6906,7 @@ public class AppOpsManager {
* long running and it has a clear start and stop delimiters. Unregistering a
* non-registered callback has no effect.
*
* @see #isOperationActive
* @see #startWatchingActive
* @see #startOp(int, int, String, boolean, String, String)
* @see #finishOp(int, int, String, String)
*/
public void stopWatchingActive(@NonNull OnOpActiveChangedListener callback) {
synchronized (mActiveWatchers) {

4
core/java/android/app/Notification.java
View File

@@ -3631,7 +3631,7 @@ public class Notification implements Parcelable
* @param shortcutId the {@link ShortcutInfo#getId() id} of the shortcut this notification
* is linked to
*
* @see Notification.BubbleMetadata.Builder#Builder(String)
* @see Notification.BubbleMetadata.Builder#Notification.BubbleMetadata.Builder(String)
*/
@NonNull
public Builder setShortcutId(String shortcutId) {
@@ -5993,7 +5993,7 @@ public class Notification implements Parcelable
* metadata matches the shortcutId set on the notification builder, if one was set.
* If the shortcutId's were specified but do not match, an exception is thrown here.
*
* @see Notification.BubbleMetadata.Builder#Builder(String)
* @see Notification.BubbleMetadata.Builder#Notification.BubbleMetadata.Builder(String)
* @see #setShortcutId(String)
*/
@NonNull

2
core/java/android/app/NotificationManager.java
View File

@@ -368,7 +368,7 @@ public class NotificationManager {
* </p>
* </p>
*
* @see {@link #addAutomaticZenRule(AutomaticZenRule)}
* @see #addAutomaticZenRule(AutomaticZenRule)
*/
@SdkConstant(SdkConstant.SdkConstantType.ACTIVITY_INTENT_ACTION)
public static final String ACTION_AUTOMATIC_ZEN_RULE =

2
core/java/android/app/backup/BackupManager.java
View File

@@ -805,7 +805,7 @@ public class BackupManager {
* has a work profile that was restored from another work profile with serial number
* {@code ancestralSerialNumber}.
*
* @see UserManager#getSerialNumberForUser(UserHandle)
* @see android.os.UserManager#getSerialNumberForUser(UserHandle)
*/
@Nullable
public UserHandle getUserForAncestralSerialNumber(long ancestralSerialNumber) {

2
core/java/android/app/role/RoleManager.java
View File

@@ -103,8 +103,6 @@ public final class RoleManager {
/**
* The name of the emergency role
*
* @see android.telephony.TelephonyManager#ACTION_EMERGENCY_ASSISTANCE
*/
public static final String ROLE_EMERGENCY = "android.app.role.EMERGENCY";

1
core/java/android/content/Context.java
View File

@@ -3639,7 +3639,6 @@ public abstract class Context {
* @see android.telephony.CarrierConfigManager
* @see #EUICC_SERVICE
* @see android.telephony.euicc.EuiccManager
* @see #MMS_SERVICE
* @see android.telephony.MmsManager
* @see #INPUT_METHOD_SERVICE
* @see android.view.inputmethod.InputMethodManager

1
core/java/android/content/pm/PackageManager.java
View File

@@ -7940,7 +7940,6 @@ public abstract class PackageManager {
*
* @return true if the drawable represents the default activity icon, false otherwise
* @see #getDefaultActivityIcon()
* @see PackageItemInfo#loadDefaultIcon(PackageManager)
* @see #getActivityIcon
* @see LauncherActivityInfo#getIcon(int)
*/

2
core/java/android/net/Ikev2VpnProfile.java
View File

@@ -803,7 +803,7 @@ public final class Ikev2VpnProfile extends PlatformVpnProfile {
* @param isMetered {@code true} if the VPN network should be treated as metered regardless
* of underlying network meteredness. Defaults to {@code true}.
* @return this {@link Builder} object to facilitate chaining of method calls
* @see NetworkCapabilities.NET_CAPABILITY_NOT_METERED
* @see NetworkCapabilities#NET_CAPABILITY_NOT_METERED
*/
@NonNull
public Builder setMetered(boolean isMetered) {

2
core/java/android/net/VpnService.java
View File

@@ -836,7 +836,7 @@ public class VpnService extends Service {
* @param isMetered {@code true} if VPN network should be treated as metered regardless of
* underlying network meteredness
* @return this {@link Builder} object to facilitate chaining method calls
* @see #setUnderlyingNetworks(Networks[])
* @see #setUnderlyingNetworks(Network[])
* @see ConnectivityManager#isActiveNetworkMetered()
*/
@NonNull

1
core/java/android/os/StrictMode.java
View File

@@ -1022,7 +1022,6 @@ public final class StrictMode {
* behaviors or empty states. Instead, apps should store data needed
* while a user is locked under device protected storage areas.
*
* @see Context#createCredentialProtectedStorageContext()
* @see Context#createDeviceProtectedStorageContext()
*/
public @NonNull Builder detectCredentialProtectedWhileLocked() {

6
core/java/android/os/VibrationEffect.java
View File

@@ -64,21 +64,16 @@ public abstract class VibrationEffect implements Parcelable {
/**
* A click effect. Use this effect as a baseline, as it's the most common type of click effect.
*
* @see #get(int)
*/
public static final int EFFECT_CLICK = Effect.CLICK;
/**
* A double click effect.
*
* @see #get(int)
*/
public static final int EFFECT_DOUBLE_CLICK = Effect.DOUBLE_CLICK;
/**
* A tick effect. This effect is less strong compared to {@link #EFFECT_CLICK}.
* @see #get(int)
*/
public static final int EFFECT_TICK = Effect.TICK;
@@ -102,7 +97,6 @@ public abstract class VibrationEffect implements Parcelable {
/**
* A heavy click effect. This effect is stronger than {@link #EFFECT_CLICK}.
* @see #get(int)
*/
public static final int EFFECT_HEAVY_CLICK = Effect.HEAVY_CLICK;

1
core/java/android/os/strictmode/CredentialProtectedWhileLockedViolation.java
View File

@@ -28,7 +28,6 @@ import android.content.Context;
* store data needed while a user is locked under device protected storage
* areas.
*
* @see Context#createCredentialProtectedStorageContext()
* @see Context#createDeviceProtectedStorageContext()
*/
public final class CredentialProtectedWhileLockedViolation extends Violation {

3
core/java/android/provider/CalendarContract.java
View File

@@ -797,7 +797,6 @@ public final class CalendarContract {
* to changes.
*
* @see DevicePolicyManager#getCrossProfileCalendarPackages(ComponentName)
* @see Settings.Secure#CROSS_PROFILE_CALENDAR_ENABLED
*/
@NonNull
public static final Uri ENTERPRISE_CONTENT_URI =
@@ -1796,7 +1795,6 @@ public final class CalendarContract {
* to changes.
*
* @see DevicePolicyManager#getCrossProfileCalendarPackages(ComponentName)
* @see Settings.Secure#CROSS_PROFILE_CALENDAR_ENABLED
*/
@NonNull
public static final Uri ENTERPRISE_CONTENT_URI =
@@ -2010,7 +2008,6 @@ public final class CalendarContract {
* {@link DevicePolicyManager#setCrossProfileCalendarPackages(ComponentName, Set)}.
*
* @see DevicePolicyManager#getCrossProfileCalendarPackages(ComponentName)
* @see Settings.Secure#CROSS_PROFILE_CALENDAR_ENABLED
*/
@NonNull
public static final Uri ENTERPRISE_CONTENT_URI =

25
core/java/android/provider/DocumentsContract.java
View File

@@ -24,7 +24,6 @@ import android.annotation.Nullable;
import android.annotation.SystemApi;
import android.annotation.TestApi;
import android.compat.annotation.UnsupportedAppUsage;
import android.content.ContentInterface;
import android.content.ContentProvider;
import android.content.ContentResolver;
import android.content.Context;
@@ -251,14 +250,14 @@ public final class DocumentsContract {
* Get string array identifies the type or types of metadata returned
* using DocumentsContract#getDocumentMetadata.
*
* @see #getDocumentMetadata(ContentInterface, Uri)
* @see #getDocumentMetadata(ContentResolver, Uri)
*/
public static final String METADATA_TYPES = "android:documentMetadataTypes";
/**
* Get Exif information using DocumentsContract#getDocumentMetadata.
*
* @see #getDocumentMetadata(ContentInterface, Uri)
* @see #getDocumentMetadata(ContentResolver, Uri)
*/
public static final String METADATA_EXIF = "android:documentExif";
@@ -266,7 +265,7 @@ public final class DocumentsContract {
* Get total count of all documents currently stored under the given
* directory tree. Only valid for {@link Document#MIME_TYPE_DIR} documents.
*
* @see #getDocumentMetadata(ContentInterface, Uri)
* @see #getDocumentMetadata(ContentResolver, Uri)
*/
public static final String METADATA_TREE_COUNT = "android:metadataTreeCount";
@@ -274,7 +273,7 @@ public final class DocumentsContract {
* Get total size of all documents currently stored under the given
* directory tree. Only valid for {@link Document#MIME_TYPE_DIR} documents.
*
* @see #getDocumentMetadata(ContentInterface, Uri)
* @see #getDocumentMetadata(ContentResolver, Uri)
*/
public static final String METADATA_TREE_SIZE = "android:metadataTreeSize";
@@ -405,7 +404,7 @@ public final class DocumentsContract {
* Flag indicating that a document can be represented as a thumbnail.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#getDocumentThumbnail(ContentInterface, Uri,
* @see DocumentsContract#getDocumentThumbnail(ContentResolver, Uri,
* Point, CancellationSignal)
* @see DocumentsProvider#openDocumentThumbnail(String, Point,
* android.os.CancellationSignal)
@@ -431,7 +430,7 @@ public final class DocumentsContract {
* Flag indicating that a document is deletable.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#deleteDocument(ContentInterface, Uri)
* @see DocumentsContract#deleteDocument(ContentResolver, Uri)
* @see DocumentsProvider#deleteDocument(String)
*/
public static final int FLAG_SUPPORTS_DELETE = 1 << 2;
@@ -469,7 +468,7 @@ public final class DocumentsContract {
* Flag indicating that a document can be renamed.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#renameDocument(ContentInterface, Uri, String)
* @see DocumentsContract#renameDocument(ContentResolver, Uri, String)
* @see DocumentsProvider#renameDocument(String, String)
*/
public static final int FLAG_SUPPORTS_RENAME = 1 << 6;
@@ -479,7 +478,7 @@ public final class DocumentsContract {
* within the same document provider.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#copyDocument(ContentInterface, Uri, Uri)
* @see DocumentsContract#copyDocument(ContentResolver, Uri, Uri)
* @see DocumentsProvider#copyDocument(String, String)
*/
public static final int FLAG_SUPPORTS_COPY = 1 << 7;
@@ -489,7 +488,7 @@ public final class DocumentsContract {
* within the same document provider.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#moveDocument(ContentInterface, Uri, Uri, Uri)
* @see DocumentsContract#moveDocument(ContentResolver, Uri, Uri, Uri)
* @see DocumentsProvider#moveDocument(String, String, String)
*/
public static final int FLAG_SUPPORTS_MOVE = 1 << 8;
@@ -513,7 +512,7 @@ public final class DocumentsContract {
* Flag indicating that a document can be removed from a parent.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#removeDocument(ContentInterface, Uri, Uri)
* @see DocumentsContract#removeDocument(ContentResolver, Uri, Uri)
* @see DocumentsProvider#removeDocument(String, String)
*/
public static final int FLAG_SUPPORTS_REMOVE = 1 << 10;
@@ -549,7 +548,7 @@ public final class DocumentsContract {
* using DocumentsContract#getDocumentMetadata
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#getDocumentMetadata(ContentInterface, Uri)
* @see DocumentsContract#getDocumentMetadata(ContentResolver, Uri)
*/
public static final int FLAG_SUPPORTS_METADATA = 1 << 14;
@@ -750,7 +749,7 @@ public final class DocumentsContract {
* Flag indicating that this root can be ejected.
*
* @see #COLUMN_FLAGS
* @see DocumentsContract#ejectRoot(ContentInterface, Uri)
* @see DocumentsContract#ejectRoot(ContentResolver, Uri)
* @see DocumentsProvider#ejectRoot(String)
*/
public static final int FLAG_SUPPORTS_EJECT = 1 << 5;

6
core/java/android/telephony/PhoneStateListener.java
View File

@@ -379,8 +379,6 @@ public class PhoneStateListener {
*
* <p>Requires permission {@link android.Manifest.permission#READ_PHONE_STATE} or the calling
* app has carrier privileges (see {@link TelephonyManager#hasCarrierPrivileges}).
*
* @see #onEmergencyNumberListChanged
*/
public static final int LISTEN_EMERGENCY_NUMBER_LIST = 0x01000000;
@@ -459,7 +457,7 @@ public class PhoneStateListener {
* <p>Requires permission {@link android.Manifest.permission#READ_PRECISE_PHONE_STATE} or
* the calling app has carrier privileges (see {@link TelephonyManager#hasCarrierPrivileges}).
*
* @see #onRegistrationFailed()
* @see #onRegistrationFailed
*/
@RequiresPermission(Manifest.permission.READ_PRECISE_PHONE_STATE)
public static final int LISTEN_REGISTRATION_FAILURE = 0x40000000;
@@ -470,7 +468,7 @@ public class PhoneStateListener {
* <p>Requires permission {@link android.Manifest.permission#READ_PRECISE_PHONE_STATE} or
* the calling app has carrier privileges (see {@link TelephonyManager#hasCarrierPrivileges}).
*
* @see #onBarringInfoChanged()
* @see #onBarringInfoChanged
*/
@RequiresPermission(Manifest.permission.READ_PRECISE_PHONE_STATE)
public static final int LISTEN_BARRING_INFO = 0x80000000;

2
core/java/android/text/style/LineBackgroundSpan.java
View File

@@ -112,7 +112,7 @@ public interface LineBackgroundSpan extends ParagraphStyle
/**
* @return the color of this span.
* @see Standard#Standard(int)
* @see Standard#LineBackgroundSpan.Standard(int)
*/
@ColorInt
public final int getColor() {

2
core/java/android/util/proto/ProtoOutputStream.java
View File

@@ -2275,7 +2275,7 @@ public final class ProtoOutputStream extends ProtoStream {
/**
* Write an individual field tag by hand.
*
* @see See <a href="https://developers.google.com/protocol-buffers/docs/encoding">Protobuf
* See <a href="https://developers.google.com/protocol-buffers/docs/encoding">Protobuf
* Encoding</a> for details on the structure of how tags and data are written.
*/
public void writeTag(int id, @WireType int wireType) {

2
core/java/android/view/VerifiedInputEvent.java
View File

@@ -92,8 +92,6 @@ public abstract class VerifiedInputEvent implements Parcelable {
* time base.
*
* @see InputEvent#getEventTime()
* @see KeyEvent#getEventTimeNano()
* @see MotionEvent#getEventTimeNano()
*/
@SuppressLint("MethodNameUnits")
public long getEventTimeNanos() {

1
core/java/android/view/WindowManager.java
View File

@@ -700,7 +700,6 @@ public interface WindowManager extends ViewManager {
* @see #TYPE_TOAST
* @see #TYPE_SYSTEM_OVERLAY
* @see #TYPE_PRIORITY_PHONE
* @see #TYPE_STATUS_BAR_PANEL
* @see #TYPE_SYSTEM_DIALOG
* @see #TYPE_KEYGUARD_DIALOG
* @see #TYPE_SYSTEM_ERROR

2
core/java/android/view/inspector/StaticInspectionCompanionProvider.java
View File

@@ -21,8 +21,6 @@ import android.annotation.Nullable;
/**
* An inspection companion provider that finds companions as inner classes or generated code.
*
* @see android.processor.view.inspector.PlatformInspectableProcessor
*/
public class StaticInspectionCompanionProvider implements InspectionCompanionProvider {
/**

4
core/java/android/view/textclassifier/ConversationActions.java
View File

@@ -105,7 +105,7 @@ public final class ConversationActions implements Parcelable {
/**
* Represents the local user.
*
* @see Builder#Builder(Person)
* @see Builder#ConversationActions.Message.Builder(Person)
*/
@NonNull
public static final Person PERSON_USER_SELF =
@@ -120,7 +120,7 @@ public final class ConversationActions implements Parcelable {
* the remote user better, so that the underlying model could differentiate between
* different remote users.
*
* @see Builder#Builder(Person)
* @see Builder#ConversationActions.Message.Builder(Person)
*/
@NonNull
public static final Person PERSON_USER_OTHERS =

4
core/java/android/widget/Toast.java
View File

@@ -714,9 +714,7 @@ public class Toast {
/**
* Callback object to be called when the toast is shown or hidden.
*
* <p>Callback methods will be called on the looper thread used for the {@link Toast} object.
*
* @see #makeText(Context, Looper, CharSequence, int)
* @see #makeText(Context, CharSequence, int)
* @see #addCallback(Callback)
*/
public abstract static class Callback {

2
core/res/res/values/attrs.xml
View File

@@ -4820,7 +4820,7 @@
May be a string value, which is a comma-separated language tag list, such as "ja-JP,zh-CN".
When not specified or an empty string is given, it will fallback to the default one.
{@see android.os.LocaleList#forLanguageTags(String)}
{@see android.text.TextView#setTextLocales(android.os.LocaleList)} -->
{@see android.widget.TextView#setTextLocales(android.os.LocaleList)} -->
<attr name="textLocale" format="string" />
<!-- Text color for links. -->
<attr name="textColorLink" />

2
graphics/java/android/graphics/RenderNode.java
View File

@@ -998,7 +998,7 @@ public final class RenderNode {
* Sets the rotation value for the display list around the Z axis.
*
* @param rotation The rotation value of the display list, in degrees
* @see View#setRotationZ(float)
* @see View#setRotation(float)
* @see #getRotationZ()
* @return True if the value changed, false if the new value was the same as the previous value.
*/

2
graphics/java/android/graphics/drawable/Drawable.java
View File

@@ -617,7 +617,7 @@ public abstract class Drawable {
* {@link #setTintList(ColorStateList) tint}.
* </p>
*
* @see {@link #setColorFilter(ColorFilter)} }
* @see #setColorFilter(ColorFilter)
* @deprecated use {@link #setColorFilter(ColorFilter)} with an instance
* of {@link android.graphics.BlendModeColorFilter}
*/

2
graphics/java/android/graphics/fonts/FontStyle.java
View File

@@ -217,7 +217,7 @@ public final class FontStyle {
/**
* Gets the weight value
*
* @see FontStyle#setWeight(int)
* @see #FontStyle(int, int)
* @return a weight value
*/
public @IntRange(from = 0, to = 1000) int getWeight() {

4
graphics/java/android/graphics/text/LineBreaker.java
View File

@@ -320,7 +320,7 @@ public class LineBreaker {
/**
* Returns the array of tab stops in pixels.
*
* @see #setTabStops(float[], int)
* @see #setTabStops
*/
public @Nullable float[] getTabStops() {
return mVariableTabStops;
@@ -329,7 +329,7 @@ public class LineBreaker {
/**
* Returns the default tab stops in pixels.
*
* @see #setTabStop(float[], int)
* @see #setTabStops
*/
public @Px @FloatRange(from = 0) float getDefaultTabStop() {
return mDefaultTabStop;

2
media/java/android/media/AudioPlaybackCaptureConfiguration.java
View File

@@ -83,7 +83,7 @@ public final class AudioPlaybackCaptureConfiguration {
/**
* @return the {@code MediaProjection} used to build this object.
* @see Builder#Builder(MediaProjection)
* @see Builder#AudioPlaybackCaptureConfiguration.Builder(MediaProjection)
*/
public @NonNull MediaProjection getMediaProjection() {
return mProjection;

2
media/java/android/media/AudioTrack.java
View File

@@ -1357,7 +1357,7 @@ public class AudioTrack extends PlayerBase
* Can only be called only if the AudioTrack is opened in offload mode
* {@see Builder#setOffloadedPlayback(boolean)}.
* Can only be called only if the AudioTrack is in state {@link #PLAYSTATE_PLAYING}
* {@see #getPlaystate()}.
* {@see #getPlayState()}.
* Use this method in the same thread as any write() operation.
*/
public void setOffloadEndOfStream() {

8
media/java/android/media/MediaMetadataRetriever.java
View File

@@ -535,7 +535,7 @@ public class MediaMetadataRetriever implements AutoCloseable {
* if such a frame cannot be retrieved. {@link Bitmap#getConfig()} can
* be used to query the actual {@link Bitmap.Config}.
*
* @see {@link #getFrameAtTime(long, int, BitmapParams)}
* @see #getFrameAtTime(long, int, BitmapParams)
*/
public @Nullable Bitmap getFrameAtTime(long timeUs, @Option int option) {
if (option < OPTION_PREVIOUS_SYNC ||
@@ -581,7 +581,7 @@ public class MediaMetadataRetriever implements AutoCloseable {
* @return A Bitmap containing a representative video frame, which
* can be null, if such a frame cannot be retrieved.
*
* @see {@link #getFrameAtTime(long, int)}
* @see #getFrameAtTime(long, int)
*/
public @Nullable Bitmap getFrameAtTime(
long timeUs, @Option int option, @NonNull BitmapParams params) {
@@ -623,7 +623,7 @@ public class MediaMetadataRetriever implements AutoCloseable {
* be used to query the actual {@link Bitmap.Config}.
* @throws IllegalArgumentException if passed in invalid option or width by height
* is less than or equal to 0.
* @see {@link #getScaledFrameAtTime(long, int, int, int, BitmapParams)}
* @see #getScaledFrameAtTime(long, int, int, int, BitmapParams)
*/
public @Nullable Bitmap getScaledFrameAtTime(long timeUs, @Option int option,
@IntRange(from=1) int dstWidth, @IntRange(from=1) int dstHeight) {
@@ -668,7 +668,7 @@ public class MediaMetadataRetriever implements AutoCloseable {
* scaled video frame, which can be null, if such a frame cannot be retrieved.
* @throws IllegalArgumentException if passed in invalid option or width by height
* is less than or equal to 0.
* @see {@link #getScaledFrameAtTime(long, int, int, int)}
* @see #getScaledFrameAtTime(long, int, int, int)
*/
public @Nullable Bitmap getScaledFrameAtTime(long timeUs, @Option int option,
@IntRange(from=1) int dstWidth, @IntRange(from=1) int dstHeight,

2
media/java/android/media/MediaRoute2Info.java
View File

@@ -364,7 +364,7 @@ public final class MediaRoute2Info implements Parcelable {
* In order to ensure uniqueness in {@link MediaRouter2} side, the value of this method
* can be different from what was set in {@link MediaRoute2ProviderService}.
*
* @see Builder#Builder(String, CharSequence)
* @see Builder#MediaRoute2Info.Builder(String, CharSequence)
*/
@NonNull
public String getId() {

2
media/java/android/media/MediaRoute2ProviderService.java
View File

@@ -356,7 +356,7 @@ public abstract class MediaRoute2ProviderService extends Service {
* {@link MediaRouter2}, or null if none. The contents of this bundle
* may affect the result of session creation.
*
* @see RoutingSessionInfo.Builder#Builder(String, String)
* @see RoutingSessionInfo.Builder#RoutingSessionInfo.Builder(String, String)
* @see RoutingSessionInfo.Builder#addSelectedRoute(String)
* @see RoutingSessionInfo.Builder#setControlHints(Bundle)
*/

2
media/java/android/media/RoutingSessionInfo.java
View File

@@ -130,7 +130,7 @@ public final class RoutingSessionInfo implements Parcelable {
* In order to ensure uniqueness in {@link MediaRouter2} side, the value of this method
* can be different from what was set in {@link MediaRoute2ProviderService}.
*
* @see Builder#Builder(String, String)
* @see Builder#RoutingSessionInfo.Builder(String, String)
*/
@NonNull
public String getId() {

2
telecomm/java/android/telecom/TelecomManager.java
View File

@@ -399,7 +399,7 @@ public class TelecomManager {
* Optional extra for communicating the call network technology used by a
* {@link android.telecom.Connection} to Telecom and InCallUI.
*
* @see {@code NETWORK_TYPE_*} in {@link android.telephony.TelephonyManager}.
* {@code NETWORK_TYPE_*} in {@link android.telephony.TelephonyManager}.
*/
public static final String EXTRA_CALL_NETWORK_TYPE =
"android.telecom.extra.CALL_NETWORK_TYPE";

2
telephony/java/android/telephony/TelephonyDisplayInfo.java
View File

@@ -62,8 +62,6 @@ public final class TelephonyDisplayInfo implements Parcelable {
* {@link TelephonyManager#NETWORK_TYPE_LTE} network and has E-UTRA-NR Dual Connectivity(EN-DC)
* capability or is currently connected to the secondary
* {@link TelephonyManager#NETWORK_TYPE_NR} cellular network on millimeter wave bands.
*
* @see AccessNetworkConstants.NgranBands#FREQUENCY_RANGE_GROUP_2
*/
public static final int OVERRIDE_NETWORK_TYPE_NR_NSA_MMWAVE = 4;

14
telephony/java/android/telephony/ims/ImsMmTelManager.java
View File

@@ -140,8 +140,7 @@ public class ImsMmTelManager implements RegistrationManager {
}
/**
* Receives IMS capability status updates from the ImsService. This information is also
* available via the {@see #isAvailable(int, int)} method below.
* Receives IMS capability status updates from the ImsService.
*
* @see #registerMmTelCapabilityCallback(Executor, CapabilityCallback) (CapabilityCallback)
* @see #unregisterMmTelCapabilityCallback(CapabilityCallback)
@@ -194,8 +193,6 @@ public class ImsMmTelManager implements RegistrationManager {
* If unavailable, the feature is not able to support the unavailable capability at this
* time.
*
* This information can also be queried using the {@see #isAvailable(int, int)} API.
*
* @param capabilities The new availability of the capabilities.
*/
public void onCapabilitiesStatusChanged(
@@ -496,8 +493,7 @@ public class ImsMmTelManager implements RegistrationManager {
/**
* Registers a {@link CapabilityCallback} with the system, which will provide MmTel service
* availability updates for the subscription specified in
* {@link ImsManager#getImsMmTelManager(int)}. The method {@see #isAvailable(int, int)}
* can also be used to query this information at any time.
* {@link ImsManager#getImsMmTelManager(int)}.
*
* Use {@link SubscriptionManager.OnSubscriptionsChangedListener} to listen to
* subscription changed events and call
@@ -639,7 +635,6 @@ public class ImsMmTelManager implements RegistrationManager {
* @see android.telephony.CarrierConfigManager#KEY_HIDE_ENHANCED_4G_LTE_BOOL
* @see android.telephony.CarrierConfigManager#KEY_ENHANCED_4G_LTE_ON_BY_DEFAULT_BOOL
* @see android.telephony.CarrierConfigManager#KEY_CARRIER_VOLTE_AVAILABLE_BOOL
* @see #setAdvancedCallingSettingEnabled(boolean)
* @throws IllegalArgumentException if the subscription associated with this operation is not
* active (SIM is not inserted, ESIM inactive) or invalid.
* @return true if the user's setting for advanced calling is enabled, false otherwise.
@@ -858,7 +853,6 @@ public class ImsMmTelManager implements RegistrationManager {
* @throws IllegalArgumentException if the subscription associated with this operation is not
* active (SIM is not inserted, ESIM inactive) or invalid.
* @return true if the user’s “Video Calling” setting is currently enabled.
* @see #setVtSettingEnabled(boolean)
*/
@RequiresPermission(anyOf = {
android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE,
@@ -933,7 +927,6 @@ public class ImsMmTelManager implements RegistrationManager {
*
* @throws IllegalArgumentException if the subscription associated with this operation is not
* active (SIM is not inserted, ESIM inactive) or invalid.
* @see #setVoWiFiSettingEnabled(boolean)
*/
@SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).
@RequiresPermission(anyOf = {
@@ -1011,7 +1004,6 @@ public class ImsMmTelManager implements RegistrationManager {
* active (SIM is not inserted, ESIM inactive) or invalid.
* @return true if the user's setting for Voice over WiFi while roaming is enabled, false
* if disabled.
* @see #setVoWiFiRoamingSettingEnabled(boolean)
*/
@SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).
@RequiresPermission(anyOf = {
@@ -1130,7 +1122,6 @@ public class ImsMmTelManager implements RegistrationManager {
* - {@link #WIFI_MODE_WIFI_ONLY}
* - {@link #WIFI_MODE_CELLULAR_PREFERRED}
* - {@link #WIFI_MODE_WIFI_PREFERRED}
* @see #setVoWiFiSettingEnabled(boolean)
*/
@SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).
@RequiresPermission(anyOf = {
@@ -1315,7 +1306,6 @@ public class ImsMmTelManager implements RegistrationManager {
*
* @throws IllegalArgumentException if the subscription associated with this operation is not
* active (SIM is not inserted, ESIM inactive) or invalid.
* @see android.telecom.TelecomManager#getCurrentTtyMode
* @see android.telephony.CarrierConfigManager#KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
*/
@SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).

2
telephony/java/android/telephony/ims/RegistrationManager.java
View File

@@ -270,7 +270,7 @@ public interface RegistrationManager {
* inactive subscription, it will result in a no-op.
*
* @param c The {@link RegistrationCallback} to be removed.
* @see SubscriptionManager.OnSubscriptionsChangedListener
* @see android.telephony.SubscriptionManager.OnSubscriptionsChangedListener
* @see #registerImsRegistrationCallback(Executor, RegistrationCallback)
*/
@RequiresPermission(Manifest.permission.READ_PRIVILEGED_PHONE_STATE)

8
telephony/java/android/telephony/ims/feature/MmTelFeature.java
View File

@@ -218,13 +218,7 @@ public class MmTelFeature extends ImsFeature {
* {@link MmTelCapabilities#CAPABILITY_TYPE_UT}, and
* {@link MmTelCapabilities#CAPABILITY_TYPE_SMS}.
*
* The capabilities of this MmTelFeature will be set by the framework and can be queried with
* {@see #queryCapabilityStatus()}.
*
* This MmTelFeature can then return the status of each of these capabilities (enabled or not)
* by sending a {@see #notifyCapabilitiesStatusChanged} callback to the framework. The current
* status can also be queried using {@see #queryCapabilityStatus()}.
* @see #isCapable(int)
* The capabilities of this MmTelFeature will be set by the framework.
*/
public static class MmTelCapabilities extends Capabilities {

2
wifi/java/android/net/wifi/WpsInfo.java
View File

@@ -22,7 +22,7 @@ import android.os.Parcelable;
/**
* A class representing Wi-Fi Protected Setup
*
* {@see WifiP2pConfig}
* {@see android.net.wifi.p2p.WifiP2pConfig}
*/
public class WpsInfo implements Parcelable {