Re: Garbled text in zic(8) man page

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, 22 Nov 2022 at 19:22, Alejandro Colomar wrote:
>
> Hi Jonathan,
>
> On 11/22/22 14:13, Jonathan Wakely wrote:
> > 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.
>
> As you said, a sync would be better.  However, I don't know how Michael did
> that.

Paul Eggert did it last time.

> If you know where the page comes from, could you please prepare a patch
> that does the sync, and document it in the commit message so that it's easier to
> do it in the future?

Upstream is https://www.iana.org/time-zones


>
> If you do that, please also sync tzfile(5) and zdump(8) in the commit.
>
> Thanks,
>
> Alex
>
>
> ---
>
> $ cat MAINTAINER_NOTES
> Externally generated pages
> ==========================
>
> A few pages come from external sources. Fixes to the pages should really
> go to the upstream source.
>
> tzfile(5), zdump(8), and zic(8) come from the tz project
> (https://www.iana.org/time-zones).
>
> bpf-helpers(7) is autogenerated from the kernel sources using scripts.
> See man-pages commits 53666f6c3 and 19c7f7839 for details.
>
> --
> <http://www.alejandro-colomar.es/>




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux