git: 4fee5114c374 - main - tzsetup(8): update paths to zone tab and tzdata source
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 19 Apr 2023 11:58:39 UTC
The branch main has been updated by yuripv:
URL: https://cgit.FreeBSD.org/src/commit/?id=4fee5114c3749f2b12404b89e616d4cb69a01c92
commit 4fee5114c3749f2b12404b89e616d4cb69a01c92
Author: Yuri Pankov <yuripv@FreeBSD.org>
AuthorDate: 2023-04-19 11:56:58 +0000
Commit: Yuri Pankov <yuripv@FreeBSD.org>
CommitDate: 2023-04-19 11:56:58 +0000
tzsetup(8): update paths to zone tab and tzdata source
tzsetup now uses zone1970.tab and zoneinfo source is located in
contrib/tzdata, update the man page accordingly.
While here, drop obsolete Tn macros and insert vertical breaks (mostly
before Dl in examples) to improve readability.
Reviewed by: pauamma_gundo.com (manpages)
Differential Revision: https://reviews.freebsd.org/D39643
---
usr.sbin/tzsetup/tzsetup.8 | 50 ++++++++++++++++++++--------------------------
1 file changed, 22 insertions(+), 28 deletions(-)
diff --git a/usr.sbin/tzsetup/tzsetup.8 b/usr.sbin/tzsetup/tzsetup.8
index 6ac5749e0aa4..62ac88d4fdc2 100644
--- a/usr.sbin/tzsetup/tzsetup.8
+++ b/usr.sbin/tzsetup/tzsetup.8
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd October 21, 2009
+.Dd April 18, 2023
.Dt TZSETUP 8
.Os
.Sh NAME
@@ -46,8 +46,7 @@ default zone.
The
.Nm
utility also determines whether any adjustment is necessary for systems where
-the hardware clock does not keep
-.Tn UTC .
+the hardware clock does not keep UTC.
.Pp
The following options are available:
.Bl -tag -offset indent -width Fl
@@ -61,8 +60,7 @@ Reinstall the zoneinfo file installed last time.
The name is obtained from
.Pa /var/db/zoneinfo .
.It Fl s
-Skip the initial question about adjusting the clock if not set to
-.Tn UTC .
+Skip the initial question about adjusting the clock if not set to UTC.
.El
.Pp
It is possible to short-circuit the menu system by specifying the
@@ -74,13 +72,9 @@ on the command line; this is intended mainly for pre-configured installation
scripts or people who know which zoneinfo they want to install.
.Sh TIMEZONE DATABASE
The contents of the timezone database are indexed by
-.Pa /usr/share/zoneinfo/zone.tab .
-This file lists, for each timezone data file, the
-.Tn ISO
-3166 territory code, approximate geographical coordinates
-(in
-.Tn ISO
-6709 format),
+.Pa /usr/share/zoneinfo/zone1970.tab .
+This file lists, for each timezone data file, the ISO 3166 territory code,
+approximate geographical coordinates (in ISO 6709 format),
and location within the territory.
.Pp
The maintainers of the database maintain the following policies:
@@ -91,31 +85,29 @@ At least one zone for every country or inhabited geographical territory.
One zone for every distinct, documented timezone history since the
beginning of the
.Ux
-epoch (January 1, 1970,
-.Tn GMT ) .
+epoch (January 1, 1970, GMT).
.It
Each zone is named for the most populous city therein.
(Where possible,
the database includes pre-1970 history for its city.)
.El
+.Pp
The source code to the database
-.Pq Pa /usr/src/share/zoneinfo/[a-z]*
+.Pq Pa /usr/src/contrib/tzdata/[a-z]*
contains many additional comments and documentation references for the
historically minded.
.Sh FILES
-.Bl -tag -width ".Pa /usr/share/zoneinfo/zone.tab" -compact
+.Bl -tag -width ".Pa /usr/share/zoneinfo/zone1970.tab" -compact
.It Pa /etc/localtime
current time zone file
.It Pa /etc/wall_cmos_clock
see
.Xr adjkerntz 8
.It Pa /usr/share/misc/iso3166
-mapping of
-.Tn ISO
-3166 territory codes to names
+mapping of ISO 3166 territory codes to names
.It Pa /usr/share/zoneinfo
directory for zoneinfo files
-.It Pa /usr/share/zoneinfo/zone.tab
+.It Pa /usr/share/zoneinfo/zone1970.tab
mapping of timezone file to country and location
.It Pa /var/db/zoneinfo
saved name of the timezone file installed last
@@ -123,21 +115,24 @@ saved name of the timezone file installed last
.Sh EXAMPLES
Normal usage, to select the right zoneinfo file via the dialog-based
user interface:
-.Dl tzsetup
+.Pp
+.Dl # tzsetup
.Pp
Install the file
.Pa /usr/share/zoneinfo/Australia/Sydney :
-.Dl "tzsetup /usr/share/zoneinfo/Australia/Sydney"
.Pp
-Install the zoneinfo file for Australia/Sydney, assumed to be located
-in
+.Dl "# tzsetup /usr/share/zoneinfo/Australia/Sydney"
+.Pp
+Install the zoneinfo file for Australia/Sydney, assumed to be located in
.Pa /usr/share/zoneinfo :
-.Dl "tzsetup Australia/Sydney"
+.Pp
+.Dl "# tzsetup Australia/Sydney"
.Pp
After a reinstall of the zoneinfo files, you can reinstall the
latest installed zoneinfo file (as specified in
.Pa /var/db/zoneinfo ) :
-.Dl "tzsetup -r"
+.Pp
+.Dl "# tzsetup -r"
.Sh SEE ALSO
.Xr date 1 ,
.Xr adjtime 2 ,
@@ -159,8 +154,7 @@ Programs which are already running when
creates or updates
.Pa /etc/localtime
will not reflect the updated timezone.
-When the system is first configured for a
-.Pf non- Tn UTC
+When the system is first configured for a non-UTC
hardware clock, it is necessary to run
.Xr adjkerntz 8
(which normally happens as a part of system startup) in order to update