diff options
Diffstat (limited to 'tzselect.8.txt')
| -rw-r--r-- | tzselect.8.txt | 77 |
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) |
