From f3b61aab48675dd13663f01aa294fc2e7e451b07 Mon Sep 17 00:00:00 2001 From: Howard Hinnant Date: Wed, 22 Mar 2017 22:52:07 -0400 Subject: [PATCH] Document set_install. --- tz.html | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/tz.html b/tz.html index c7d254e..2c745ba 100644 --- a/tz.html +++ b/tz.html @@ -26,7 +26,7 @@

Howard E. Hinnant
-2017-03-02
+2017-03-22

Time Zone Database Parser

@@ -928,6 +928,37 @@ be returned to a valid TZ_DB.

+
+void set_install(const std::string& s);
+
+
+

+Effects: Sets the location which the database is, or will be, installed at. +

+

+Default: If this function is never called, and the macro INSTALL is +defined, the location of the database is INSTALL/tzdata +(INSTALL\tzdata on Windows). If the macro INSTALL is not +defined, the default location of the database is ~/Downloads/tzdata +(%homedrive%\%homepath%\downloads\tzdata on Windows). +

+

+Thread Safety: This function is not thread safe. You must +provide your own synchronization among threads calling this function. It should be +called prior to any other access to the database. +

+

+Throws: Anything assignment to std::string might throw. +

+

+Note: No expansion is attempted on the argument s (e.g. expanding +~/). This is a low-level function meant to enable other expansion techniques +such as +xdg-user-dirs whose +result can be passed directly to set_install. +

+
+

The following functions are available only if you compile with the configuration macro HAS_REMOTE_API == 1. Use of this API requires linking to