GNU bug report logs - #70498
[PATCH] Fix the user manual for `calendar-time-zone-style'

Previous Next

To reply to this bug, email your comments to 70498 AT debbugs.gnu.org.
There is no need to reopen the bug first.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Gautier Ponsinet <gautier <at> gautierponsinet.xyz>
To: bug-gnu-emacs <at> gnu.org
Subject: [PATCH] Fix the user manual for `calendar-time-zone-style'
Date: Sun, 21 Apr 2024 15:47:18 +0200

[Message part 1 (text/plain, inline)]

Tags: patch

Hello everyone,

The manual for the calendar in emacs currently contains this paragraph:

   If you want to display numerical time zones (like ‘"+0100"’) instead
of symbolic ones (like ‘"CET"’), set this to ‘numeric’.

But it is nowhere explain what "this" refer to, it is the variable
`calendar-time-zone-style'.

Please find attached to this mail a patch which rephrase the manual to
refer explicitely to `calendar-time-zone-style'.


In GNU Emacs 30.0.50 (build 1, x86_64-pc-linux-gnu, X toolkit, cairo
 version 1.18.0, Xaw3d scroll bars) of 2024-04-19 built on
 gautier-laptop
Repository revision: 473189ab6902b0488f8001fdf993522b82740663
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101013
System Description: Arch Linux

Configured using:
 'configure --prefix=/usr --sysconfdir=/etc --libexecdir=/usr/lib
 --localstatedir=/var --mandir=/usr/share/man --with-gameuser=:games
 --with-modules --without-m17n-flt --without-gconf
 --with-native-compilation=no --with-xinput2 --with-x-toolkit=lucid
 --without-xft --with-xaw3d --with-sound=no --with-tree-sitter
 --without-gpm --without-compress-install
 '--program-transform-name=s/\([ec]tags\)/\1.emacs/'
 'CFLAGS=-march=x86-64 -mtune=generic -O2 -pipe -fno-plt -fexceptions
 -Wp,-D_FORTIFY_SOURCE=3 -Wformat -Werror=format-security
 -fstack-clash-protection -fcf-protection -fno-omit-frame-pointer
 -mno-omit-leaf-frame-pointer -g
 -ffile-prefix-map=/home/gautier/.packages/aur/emacs-git/src=/usr/src/debug/emacs-git
 -flto=auto' 'LDFLAGS=-Wl,-O1 -Wl,--sort-common -Wl,--as-needed
 -Wl,-z,relro -Wl,-z,now -Wl,-z,pack-relative-relocs -flto=auto''

[0001-Fix-the-user-manual-for-calendar-time-zone-style.patch (text/patch, attachment)]

Message #10 received at 70498-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Gautier Ponsinet <gautier <at> gautierponsinet.xyz>
Cc: 70498-done <at> debbugs.gnu.org
Subject: Re: bug#70498: [PATCH] Fix the user manual for
 `calendar-time-zone-style'
Date: Sun, 21 Apr 2024 19:50:51 +0300

> From: Gautier Ponsinet <gautier <at> gautierponsinet.xyz>
> Date: Sun, 21 Apr 2024 15:47:18 +0200
> 
> The manual for the calendar in emacs currently contains this paragraph:
> 
>    If you want to display numerical time zones (like ‘"+0100"’) instead
> of symbolic ones (like ‘"CET"’), set this to ‘numeric’.
> 
> But it is nowhere explain what "this" refer to, it is the variable
> `calendar-time-zone-style'.

yes.  Evidently, someone foprgot that @vindex is not shown in the Info
manual.

> Please find attached to this mail a patch which rephrase the manual to
> refer explicitely to `calendar-time-zone-style'.

Thanks, installed on the emacs-29 branch.  I also made a few more
similar changes there.

With that, I'm closing this bug.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.