Move README to share/zoneinfo.
authorSascha Wildner <swildner@dragonflybsd.org>
Sat, 8 Mar 2008 11:55:59 +0000 (11:55 +0000)
committerSascha Wildner <swildner@dragonflybsd.org>
Sat, 8 Mar 2008 11:55:59 +0000 (11:55 +0000)
share/zoneinfo/README [moved from usr.sbin/zic/README with 72% similarity]

similarity index 72%
rename from usr.sbin/zic/README
rename to share/zoneinfo/README
index 5de3d74..c0cc928 100644 (file)
@@ -1,4 +1,4 @@
-@(#)README     7.10
+@(#)README     8.2
 
 "What time is it?" -- Richard Deacon as The King
 "Any time you want it to be." -- Frank Baxter as The Scientist
@@ -33,13 +33,29 @@ Since POSIX frowns on correct leap second handling, the default behavior of
 the "zic" command (in the absence of a "-L" option) has been changed to omit
 leap second information from its output files.
 
-Be sure to read the comments in "Makefile" and make any changes
-needed to make things right for your system.
+Here is a recipe for acquiring, building, installing, and testing the
+tz distribution on a GNU/Linux or similar host.
+
+       mkdir tz
+       cd tz
+       wget 'ftp://elsie.nci.nih.gov/pub/tz*.tar.gz'
+       gzip -dc tzcode*.tar.gz | tar -xf -
+       gzip -dc tzdata*.tar.gz | tar -xf -
+
+Be sure to read the comments in "Makefile" and make any changes needed
+to make things right for your system, especially if you are using some
+platform other than GNU/Linux.  Then run the following commands,
+substituting your desired installation directory for "$HOME/tzdir":
+
+       make TOPDIR=$HOME/tzdir install
+       $HOME/tzdir/etc/zdump -v America/Los_Angeles
 
 To use the new functions, use a "-ltz" option when compiling or linking.
 
-Historical local time information has been included here not because it
-is particularly useful, but rather to:
+Historical local time information has been included here to:
+
+*      provide a compendium of data about the history of civil time
+       that is useful even if the data are not 100% accurate;
 
 *      give an idea of the variety of local time rules that have
        existed in the past and thus an idea of the variety that may be
@@ -49,7 +65,9 @@ is particularly useful, but rather to:
        system.
 
 The information in the time zone data files is by no means authoritative;
-if you know that the rules are different from those in a file, by all means
+the files currently do not even attempt to cover all time stamps before
+1970, and there are undoubtedly errors even for time stamps since 1970.
+If you know that the rules are different from those in a file, by all means
 feel free to change file (and please send the changed version to
 tz@elsie.nci.nih.gov for use in the future).  Europeans take note!