Improve docs for the tzdata file
The tzdata file is now being used in more cases as bionic finds more
niches. This commit improves the Android.bp docs to reflect this.
Bug: 171754977
Test: None
Change-Id: I9cd75098836617d2865242e0a3c576639f171c64
diff --git a/output_data/iana/Android.bp b/output_data/iana/Android.bp
index 650549a..2dd51b9 100644
--- a/output_data/iana/Android.bp
+++ b/output_data/iana/Android.bp
@@ -12,16 +12,25 @@
// See the License for the specific language governing permissions and
// limitations under the License.
+// Build rules related to the tzdata file.
+// tzdata is a binary file used by bionic functions like mktime / localtime and
+// Android's implementation of java.util.TimeZone, ZoneInfoDb. Both these users
+// look for the file in multiple locations. Also see the com.android.tzdata
+// APEX definition.
+
+// The on-device version of the tzdata file in /system/usr/share/zoneinfo/
+// This is the ultimate fallback for bionic for situations where the
+// tzdata APEX is not mounted. For example, bionic in initd. It is also
+// referenced by old copies of bionic that may be statically linked
+// via the NDK. It is no longer used by ZoneInfoDb.
prebuilt_usr_share {
name: "tzdata",
src: "tzdata",
sub_dir: "zoneinfo",
}
-// A host version of the tzdata module for use by
-// hostdex rules.
-
-// Simulate /system
+// The host version of the tzdata file equivalent to the definition above.
+// Used by bionic on host; bionic is being increasingly used on host for tooling.
prebuilt_usr_share_host {
name: "tzdata_host",
src: "tzdata",