aboutsummaryrefslogtreecommitdiff
path: root/tzselect.8.txt
diff options
context:
space:
mode:
Diffstat (limited to 'tzselect.8.txt')
-rw-r--r--tzselect.8.txt77
1 files changed, 77 insertions, 0 deletions
diff --git a/tzselect.8.txt b/tzselect.8.txt
new file mode 100644
index 000000000000..991475087bdc
--- /dev/null
+++ b/tzselect.8.txt
@@ -0,0 +1,77 @@
+TZSELECT(8) System Manager's Manual TZSELECT(8)
+
+NAME
+ tzselect - select a time zone
+
+SYNOPSIS
+ tzselect [ -c coord ] [ -n limit ] [ --help ] [ --version ]
+
+DESCRIPTION
+ The tzselect program asks the user for information about the current
+ location, and outputs the resulting time zone description to standard
+ output. The output is suitable as a value for the TZ environment
+ variable.
+
+ All interaction with the user is done via standard input and standard
+ error.
+
+OPTIONS
+ -c coord
+ Instead of asking for continent and then country and then city,
+ ask for selection from time zones whose largest cities are
+ closest to the location with geographical coordinates coord.
+ Use ISO 6709 notation for coord, that is, a latitude immediately
+ followed by a longitude. The latitude and longitude should be
+ signed integers followed by an optional decimal point and
+ fraction: positive numbers represent north and east, negative
+ south and west. Latitudes with two and longitudes with three
+ integer digits are treated as degrees; latitudes with four or
+ six and longitudes with five or seven integer digits are treated
+ as DDMM, DDDMM, DDMMSS, or DDDMMSS representing DD or DDD
+ degrees, MM minutes, and zero or SS seconds, with any trailing
+ fractions represent fractional minutes or (if SS is present)
+ seconds. The decimal point is that of the current locale. For
+ example, in the (default) C locale, -c +40.689-074.045 specifies
+ 40.689oN, 74.045oW, -c +4041.4-07402.7 specifies 40o41.4'N,
+ 74o2.7'W, and -c +404121-0740240 specifies 40o41'21''N,
+ 74o2'40''W. If coord is not one of the documented forms, the
+ resulting behavior is unspecified.
+
+ -n limit
+ When -c is used, display the closest limit locations (default
+ 10).
+
+ --help Output help information and exit.
+
+ --version
+ Output version information and exit.
+
+ENVIRONMENT VARIABLES
+ AWK Name of a Posix-compliant awk program (default: awk).
+
+ TZDIR Name of the directory containing time zone data files (default:
+ /usr/share/zoneinfo).
+
+FILES
+ TZDIR/iso3166.tab
+ Table of ISO 3166 2-letter country codes and country names.
+
+ TZDIR/zone1970.tab
+ Table of country codes, latitude and longitude, zone names, and
+ descriptive comments.
+
+ TZDIR/TZ
+ Time zone data file for time zone TZ.
+
+EXIT STATUS
+ The exit status is zero if a time zone was successfully obtained from
+ the user, nonzero otherwise.
+
+SEE ALSO
+ newctime(3), tzfile(5), zdump(8), zic(8)
+
+NOTES
+ Applications should not assume that tzselect's output matches the
+ user's political preferences.
+
+ TZSELECT(8)