On Tue, 22 Nov 2022 at 13:00, Jonathan Wakely wrote:
>
> On Tue, 22 Nov 2022 at 12:58, Jonathan Wakely wrote:
> >
> > Hi,
> >
> > The description of the RULES field of a Zone line at:
> > https://man7.org/linux/man-pages/man8/zic.8.html#FILES
> > seems garbled:
> > "giving of the amount of time to be added to local standard time effect"
> >
> > It looks like it might be a copy&paste error from the similar text for
> > the SAVE field of a Rule line. I think the first "of" and the "effect"
> > should be removed, but I'm not sure if that's correct.
>
> This was introduced by
> https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/man8/zic.8?id=5355e20f816e1e0af93d6bb80439e86f2d1c7be7
> so maybe it should be reported to tzdb upstream instead.
It's already fixed upstream. The version in the tzdb-2022f package says:
RULES The name of the rules that apply in the timezone or,
alternatively, a field in the same format as a rule-line SAVE
column, giving the amount of time to be added to local standard
time and whether the resulting time is standard or daylight
saving. If this field is - then standard time always applies.
When an amount of time is given, only the sum of standard time
and this amount matters.
So here's a patch for the man page. There are lots of other changes in
the upstream page though, so another sync might be useful.
commit 1c9a4d9bd240dfe2aaef396b5eb0788eeabf3791
Author: Jonathan Wakely <jwakely@xxxxxxxxxx>
Date: Tue Nov 22 13:10:55 2022 +0000
zic.8: Fix garbled sentence
This corrected text now matches the corresponding section of the
upstream man page.
Signed-off-by: Jonathan Wakely <jwakely@xxxxxxxxxx>
diff --git a/man8/zic.8 b/man8/zic.8
index 79b06ae7c..d633ce7bb 100644
--- a/man8/zic.8
+++ b/man8/zic.8
@@ -502,8 +502,8 @@ begin the field with a minus sign if time must be subtracted from UT.
.B RULES
The name of the rules that apply in the timezone or,
alternatively, a field in the same format as a rule-line SAVE column,
-giving of the amount of time to be added to local standard time
-effect, and whether the resulting time is standard or daylight saving.
+giving the amount of time to be added to local standard time
+and whether the resulting time is standard or daylight saving.
If this field is
.B \*-
then standard time always applies.
