[tz] [PATCH 1/1] Document tzselect std out redirection
J William Piggott
elseifthen at gmx.com
Wed Mar 2 22:35:55 UTC 2016
* tzselect.8: Implement this.
Signed-off-by: J William Piggott <elseifthen at gmx.com>
Question: What does the following sentence from this man-page mean?
Applications should not assume that tzselect's output matches the
user's political preferences.
How can a TZ string define ones political preference?
tzselect.8 | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/tzselect.8 b/tzselect.8
index fb39e1f..19f63bb 100644
@@ -19,10 +19,16 @@ tzselect \- select a time zone
-program asks the user for information about the current location,
-and outputs the resulting time zone description to standard output.
+program asks the user for information about a target location,
+and outputs the corresponding time zone description to standard output.
The output is suitable as a value for the TZ environment variable.
+If standard output is redirected to anything other than a terminal,
+then the instructions following the confirmation prompt are not printed.
+This is to facilitate calling
+from another program.
All interaction with the user is done via standard input and standard error.
More information about the tz