diff options
Diffstat (limited to 'tzselect.8.txt')
| -rw-r--r-- | tzselect.8.txt | 84 |
1 files changed, 60 insertions, 24 deletions
diff --git a/tzselect.8.txt b/tzselect.8.txt index a492401b8219..9c6af9413bdb 100644 --- a/tzselect.8.txt +++ b/tzselect.8.txt @@ -1,41 +1,77 @@ -NAME +TZSELECT(8) System Manager's Manual TZSELECT(8) - tzselect - select a time zone +NAME + tzselect - select a timezone SYNOPSIS - tzselect + 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. + The tzselect program asks the user for information about the current + location, and outputs the resulting timezone 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.689 degrees N, 74.045 degrees W, -c +4041.4-07402.7 specifies + 40 degrees 41.4 minutes N, 74 degrees 2.7 minutes W, and + -c +404121-0740240 specifies 40 degrees 41 minutes 21 seconds N, + 74 degrees 2 minutes 40 seconds W. If coord is not one of the + documented forms, the resulting behavior is unspecified. - All interaction with the user is done via standard input and - standard error. + -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). + AWK Name of a Posix-compliant awk program (default: awk). - TZDIR - Name of the directory containing time zone data files - (default: /usr/local/etc/zoneinfo). + TZDIR Name of the directory containing timezone data files (default: + /usr/share/zoneinfo). FILES - TZDIR/iso3166.tab - Table of ISO 3166 2-letter country codes and country - names. + TZDIR/iso3166.tab + Table of ISO 3166 2-letter country codes and country names. - TZDIR/zone.tab - Table of country codes, latitude and longitude, TZ - values, and descriptive comments. + TZDIR/zone1970.tab + Table of country codes, latitude and longitude, timezones, and + descriptive comments. - TZDIR/TZ - Time zone data file for time zone TZ. + TZDIR/TZ + Timezone data file for timezone TZ. EXIT STATUS - The exit status is zero if a time zone was successfully - obtained from the user, nonzero otherwise. + The exit status is zero if a timezone was successfully obtained from + the user, nonzero otherwise. SEE ALSO - newctime(3), tzfile(5), zdump(8), zic(8) + 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) |