Merge "Revert "Change the default docs build to use module stubs"" am: 56e85bb8c0 am: d23ac2655d am: 221a2267c3 am: f3d020454f am: d551b3eb55

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1869970

Change-Id: I00c1f73e560972785b1b549637e9af713aac22e8

ApiDocs.bp

@@ -112,6 +112,7 @@ stubs_defaults {
 }
 
 // Defaults module for doc-stubs targets that use module source code as input.
+// This is the default/normal.
 stubs_defaults {
     name: "framework-doc-stubs-sources-default",
     defaults: ["framework-doc-stubs-default"],
@@ -146,6 +147,12 @@ droidstubs {
         " --show-annotation android.annotation.SystemApi\\(client=android.annotation.SystemApi.Client.PRIVILEGED_APPS\\) ",
 }
 
+droidstubs {
+    name: "framework-doc-stubs",
+    defaults: ["framework-doc-stubs-sources-default"],
+    args: metalava_framework_docs_args,
+}
+
 droidstubs {
     name: "framework-doc-system-stubs",
     defaults: ["framework-doc-stubs-sources-default"],
@@ -154,8 +161,11 @@ droidstubs {
     api_levels_sdk_type: "system",
 }
 
+// Experimental target building doc stubs with module stub source code as input.
+// This is intended to eventually replace framework-doc-stubs, once all diffs
+// have been eliminated.
 droidstubs {
-    name: "framework-doc-stubs",
+    name: "framework-doc-stubs-module-stubs",
     defaults: ["framework-doc-stubs-default"],
     args: metalava_framework_docs_args,
     srcs: [