summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
author Anton Hansson <hansson@google.com> 2021-05-05 19:22:52 +0100
committer Anton Hansson <hansson@google.com> 2021-05-10 17:06:04 +0100
commit76ac4cc96fed762b268416b5d7d54242b6f6339c (patch)
tree5fd8069b9f4e19d865775cdf12ede12b4e20ac86
parent2e25fdc90f3da2fbf7df9378fe60b51b4f184b7c (diff)
Apply the same filtering for docstubs and jarstubs
A package filter was previously applied to just the jarstubs package, but not the docstubs. This lead to various internal classes appearing in the public documentation. Fix that to apply the same filter for both. This removes the following classes from the docs: android/telephony/PackageChangeReceiver com/android/net/module/util/CollectionUtils com/android/net/module/util/ConnectivityUtils com/android/net/module/util/NetworkCapabilitiesUtils com/android/net/module/util/NetworkIdentityUtils com/google/android/collect/Lists com/google/android/collect/Maps com/google/android/collect/Sets com/google/android/gles_jni/EGLConfigImpl com/google/android/gles_jni/EGLContextImpl com/google/android/gles_jni/EGLDisplayImpl com/google/android/gles_jni/EGLImpl com/google/android/gles_jni/EGLSurfaceImpl com/google/android/gles_jni/GLImpl com/google/android/util/AbstractMessageParser com/google/android/util/AbstractMessageParser$Acronym com/google/android/util/AbstractMessageParser$FlickrPhoto com/google/android/util/AbstractMessageParser$Format com/google/android/util/AbstractMessageParser$Html com/google/android/util/AbstractMessageParser$Link com/google/android/util/AbstractMessageParser$MusicTrack com/google/android/util/AbstractMessageParser$Part com/google/android/util/AbstractMessageParser$Photo com/google/android/util/AbstractMessageParser$Resources com/google/android/util/AbstractMessageParser$Smiley com/google/android/util/AbstractMessageParser$Token com/google/android/util/AbstractMessageParser$Token$Type com/google/android/util/AbstractMessageParser$TrieNode com/google/android/util/AbstractMessageParser$Video com/google/android/util/AbstractMessageParser$YouTubeVideo com/google/android/util/Procedure com/google/android/util/SmileyParser com/google/android/util/SmileyResources Bug: 187386774 Test: diff framework-doc-stubs/../api-versions.xml before and after Change-Id: I85b1485b4c5bc1b30a5d537e96d961382f298fb7
-rw-r--r--Android.bp14
-rw-r--r--ApiDocs.bp1
-rw-r--r--StubLibraries.bp14
3 files changed, 15 insertions, 14 deletions
diff --git a/Android.bp b/Android.bp
index c916f5d4eb79..c7ab00f99d08 100644
--- a/Android.bp
+++ b/Android.bp
@@ -435,6 +435,19 @@ metalava_framework_docs_args = "--manifest $(location core/res/AndroidManifest.x
"--api-lint-ignore-prefix junit. " +
"--api-lint-ignore-prefix org. "
+packages_to_document = [
+ "android",
+ "dalvik",
+ "java",
+ "javax",
+ "junit",
+ "org.apache.http",
+ "org.json",
+ "org.w3c.dom",
+ "org.xml.sax",
+ "org.xmlpull",
+]
+
filegroup {
name: "android-non-updatable-stub-sources",
srcs: [
@@ -493,6 +506,7 @@ stubs_defaults {
// NOTE: The below can be removed once the prebuilt stub contains IKE.
"sdk_system_current_android.net.ipsec.ike",
],
+ filter_packages: packages_to_document,
high_mem: true, // Lots of sources => high memory use, see b/170701554
installable: false,
annotations_enabled: true,
diff --git a/ApiDocs.bp b/ApiDocs.bp
index 707b8c57883e..83ace022950d 100644
--- a/ApiDocs.bp
+++ b/ApiDocs.bp
@@ -96,6 +96,7 @@ stubs_defaults {
libs: framework_docs_only_libs,
create_doc_stubs: true,
annotations_enabled: true,
+ filter_packages: packages_to_document,
api_levels_annotations_enabled: true,
api_levels_annotations_dirs: [
"sdk-dir",
diff --git a/StubLibraries.bp b/StubLibraries.bp
index 96aac1ab9efa..626f9772655d 100644
--- a/StubLibraries.bp
+++ b/StubLibraries.bp
@@ -27,24 +27,10 @@
// Common metalava configs
/////////////////////////////////////////////////////////////////////
-packages_to_document = [
- "android",
- "dalvik",
- "java",
- "javax",
- "junit",
- "org.apache.http",
- "org.json",
- "org.w3c.dom",
- "org.xml.sax",
- "org.xmlpull",
-]
-
stubs_defaults {
name: "metalava-non-updatable-api-stubs-default",
defaults: ["android-non-updatable-stubs-defaults"],
api_levels_annotations_enabled: false,
- filter_packages: packages_to_document,
defaults_visibility: ["//visibility:private"],
}