Index | Thread | Search

From:
Theo Buehler <tb@theobuehler.org>
Subject:
Re: strftime.3: clarify %G and %g description
To:
"Todd C. Miller" <millert@openbsd.org>
Cc:
Christian Weisgerber <naddy@mips.inka.de>, tech@openbsd.org, Ingo Schwarze <schwarze@openbsd.org>, Lucas Gabriel Vuotto <lucas@sexy.is>
Date:
Wed, 24 Apr 2024 11:21:17 +0200

Download raw body.

Thread
On Tue, Apr 23, 2024 at 07:55:03PM -0600, Todd C. Miller wrote:
> On Tue, 23 Apr 2024 21:43:44 +0200, Christian Weisgerber wrote:
> 
> > Lucas Gabriel Vuotto just pointed out that got(1) was mistakenly
> > using %G to get the year with strftime().  This is a trap set by a
> > poor description in our strftime.3.  I suggest the clarification
> > below, taken from FreeBSD.
> 
> I still find that confusing.  I think "majority" would be better
> than "greater part" but it still lacks a real description for the
> option.  I don't think it is reasonable to expect people to understand
> the finer points of ISO 8601.
> 
> Upstream tzcode also refers to the %V option which has a description
> of ISO 8601 week numbers.  Perhaps we should just update our
> manual based on that.

There's also a long description in the STANDARDS section. Maybe it's
enough to say 'See the description of %V and the STANDARDS section for
details.' in %g and %G rather than adding a third variant of the
necessarily confusing explanation.