-static std::string install{"~/Downloads/tzdata"}; // "c:\\tzdata" on Windows
+static std::string install{"~/Downloads/tzdata"}; // "c:\%homedrive%\%homepath%\downloads\tzdata" on Windows
-You should set this such that install points to the directory
-where your library or application can find the downloaded and uncompressed
-IANA Time Zone Database (or where
-you want the software to install it for you if you compile with
-AUTO_DOWNLOAD == 1).
+You should set this such that install points to the directory where your
+library or application can find the downloaded and uncompressed IANA Time Zone Database -- tzdataYYYYv.tar.gz
+(or where you want the software to install it for you if you compile with
+AUTO_DOWNLOAD == 1). On Windows a utility such as
+7-zip can be used to decompress the database.
@@ -2972,6 +2973,40 @@ it if it hasn't been installed, and if it has, will use the remote API to instal latest version if not already installed.
+
+If you want to enable HAS_REMOTE_API and/or AUTO_DOWNLOAD on
+Windows you will have to manually install
+curl and
+7-zip into their default locations.
+
+If you do not enable HAS_REMOTE_API, you will need to also install
+
+http://unicode.org/repos/cldr/trunk/common/supplemental/windowsZones.xml into your
+install location. This will be done for you if you have enabled
+HAS_REMOTE_API and let AUTO_DOWNLOAD default to 1.
+
+To enable HAS_REMOTE_API you can either edit tz.h, adding:
+
+ ++#define HAS_REMOTE_API 1 +
+Or you can put /DHAS_REMOTE_API=1 on the command line. When
+HAS_REMOTE_API == 1, AUTO_DOWNLOAD defaults to 1.
+
+mingw users: -lpthread is required.
+