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 20:37, Alejandro Colomar <alx.manpages@xxxxxxxxx> wrote:
>
> Hi Jonathan, Paul,
>
> On 11/22/22 21:31, Jonathan Wakely wrote:
> > 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.
>
> Thanks!
>
> >
> >> 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
>
> Ahh, I remember last time I wanted to check the source code I desisted because
> there's no git repository, and I didn't want to be messing with tarballs.  But
> getting the pages from the tarball seems easy, so I'll do that.
>
> Paul, do you have a public git (or whatever) repository that I can check out?


It looks like there are a few local changes such as replacing
"degrees" with the degrees symbol, which should probably be preserved
rather than overwritten by a sync. So it's not just as simple as
overwriting with the upstream copy. I can try to look into it, but it
won't be very soon.




[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