[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
--- a/tzselect.8
+++ b/tzselect.8
@@ -19,10 +19,16 @@ tzselect \- select a time zone
 .B tzselect
-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
+.B tzselect
+from another program.
 All interaction with the user is done via standard input and standard error.

More information about the tz mailing list