[PATCH] strftime.3: document how %z and %Z are calculated

[PATCH] strftime.3: document how %z and %Z are calculated

[Paul Eggert]

---
 man3/strftime.3 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/man3/strftime.3 b/man3/strftime.3
index 57b2a38aa..90248d0b4 100644
--- a/man3/strftime.3
+++ b/man3/strftime.3
@@ -417,6 +417,8 @@ The
 or
 .I \-hhmm
 numeric timezone (that is, the hour and minute offset from UTC). (SU)
+(Calculated from
+.IR tm_gmtoff .)
 .TP
 .B %Z
 The timezone name or abbreviation.
@@ -427,6 +429,8 @@ The timezone name or abbreviation.
 The date and time in
 .BR date (1)
 format. (TZ)
+(Calculated from
+.IR tm_zone .)
 (Not supported in glibc2.)
 .TP
 .B %%
-- 
2.39.2

Re: [PATCH] strftime.3: document how %z and %Z are calculated

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1220 bytes --]

Hi Paul,

Thanks for resending inline!  :)

Another thing: please CC or TO me; otherwise I might miss the email.
See the ./CONTRIBUTING file in the repo for more details if necessary.


On 3/8/23 21:53, Paul Eggert wrote:

Would you please add some links in the commit message
to the discussion you had about this?

> ---
>  man3/strftime.3 | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/man3/strftime.3 b/man3/strftime.3
> index 57b2a38aa..90248d0b4 100644
> --- a/man3/strftime.3
> +++ b/man3/strftime.3
> @@ -417,6 +417,8 @@ The
>  or
>  .I \-hhmm
>  numeric timezone (that is, the hour and minute offset from UTC). (SU)

My question was about this "(SU)" marker.  Should we move it to after
the new sentence maybe?  (Same for "(TZ)" below.)

Cheers,

Alex

> +(Calculated from
> +.IR tm_gmtoff .)
>  .TP
>  .B %Z
>  The timezone name or abbreviation.
> @@ -427,6 +429,8 @@ The timezone name or abbreviation.
>  The date and time in
>  .BR date (1)
>  format. (TZ)
> +(Calculated from
> +.IR tm_zone .)
>  (Not supported in glibc2.)
>  .TP
>  .B %%

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]