Add information about lib/zi files to the JDK File Structure docs:

  http://rhea:91/j2se/1.5.0/docs/tooldocs/solaris/jdkfiles.html
  http://rhea:91/j2se/1.5.0/docs/tooldocs/linux/jdkfiles.html
  http://rhea:91/j2se/1.5.0/docs/tooldocs/windows/jdkfiles.html


Detail -------------------------

Now I know more about timezones than I ever wanted to.

One of the CDC docs I'm writing is the CDC Runtime Guide. Think of it as a systems admin guide for CDC, all the runtime information a user or developer could ever need. One of the chapters is on the software contents of the CDC Java runtime environment. You have something like this in the "Java 2 SDK and Runtime Environment File Structure" doc. When I went through our file layout for CDC 1.1 (which is J2SE 1.4.2 based) I found the new lib/zi files, which also appear in the J2SE 1.4.2 JRE.

There's two levels of description, runtime and build time. I'll have a simple description for the RTG:

       Time zone data files used by sun.util.calendar.ZoneInfoFile

  lib/zi/America/Los_Angeles
  lib/zi/GMT
  lib/zi/ZoneInfoMappings

and then slightly more complex description of how to build these (really just pointing to the sun.util.calendar.ZoneInfoFile javadoc) in the build guide.

So you may want to add something like the above to your file structure doc.