Update API preamble (talk about 'current' case)
The API preamble goes on API files, but on 'current' files, this was
confusing some people, because it seemed like these files could not be
changed.
Here, I went the easier approach of explaining both types of API files
in the header, rather than generating a different header for 'current'
API files. This may be confusing, but on the other hand, it avoids
additional arguments/build complexity, and the additional information is
probably helpful even on frozen API files - sure those files can't be
changed, but this explains how later 'current' API snapshots can be
updated.
Fixes: 175801423
Test: update all 'current' APIs in this directory, with this
very hacky bash one liner (and confirm things build):
for i in $(grep -rn "aidl_interface {" -C2 --include="Android.bp" \
| grep name: | grep -oP "(?<= \")[^\"]*" \
| sed s,$,-update-api,); do m $i; done
Change-Id: I90cf76f526800f7c65da063aecc0ea4c32fdf2eb
diff --git a/aidl.h b/aidl.h
index 21598d5..22bd2f7 100644
--- a/aidl.h
+++ b/aidl.h
@@ -58,13 +58,14 @@
// THIS FILE IS IMMUTABLE. DO NOT EDIT IN ANY CASE. //
///////////////////////////////////////////////////////////////////////////////
-// This file is a snapshot of an AIDL interface (or parcelable). Do not try to
-// edit this file. It looks like you are doing that because you have modified
-// an AIDL interface in a backward-incompatible way, e.g., deleting a function
-// from an interface or a field from a parcelable and it broke the build. That
-// breakage is intended.
+// This file is a snapshot of an AIDL file. Do not edit it manually. There are
+// two cases:
+// 1). this is a frozen version file - do not edit this in any case.
+// 2). this is a 'current' file. If you make a backwards compatible change to
+// the interface (from the latest frozen version), the build system will
+// prompt you to update this file with `m <name>-update-api`.
//
-// You must not make a backward incompatible changes to the AIDL files built
+// You must not make a backward incompatible change to any AIDL file built
// with the aidl_interface module type with versions property set. The module
// type is used to build AIDL files in a way that they can be used across
// independently updatable components of the system. If a device is shipped