Re: Issue in man page tzfile.5

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

 



Hi Helge,

On Sun, Nov 17, 2024 at 10:46:25AM GMT, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    timezone → B<timezone>(3)
> 
> "It seems that timezone uses B<tzfile> internally, but glibc refuses to "
> "expose it to userspace.  This is most likely because the standardised "
> "functions are more useful and portable, and actually documented by glibc.  "
> "It may only be in glibc just to support the non-glibc-maintained timezone "
> "data (which is maintained by some other entity)."

You're right, but this is a Debian patch.  I've CCed Tobias.
I suggest transforming

	+It seems that timezone uses

into

	+It seems that
	+.BR timezone (1)
	+uses

Reported-by: Helge Kreutzmann <debian@xxxxxxxxxxxxx>
Reported-by: Alejandro Colomar <alx@xxxxxxxxxx>
Suggested-by: Alejandro Colomar <alx@xxxxxxxxxx>

Cheers,
Alex



alx@debian:~/src/debian/doc/manpages/debian/latest/debian/patches$ cat ./0010-tzfile.5.patch
From: "Dr. Tobias Quathamer" <toddy@xxxxxxxxxx>
Date: Sat, 6 Feb 2016 01:25:30 +0100
Subject: tzfile.5

---
 man/man5/tzfile.5 | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/man/man5/tzfile.5 b/man/man5/tzfile.5
index 4aa3f6c..d0cefa9 100644
--- a/man/man5/tzfile.5
+++ b/man/man5/tzfile.5
@@ -210,6 +210,22 @@ if either
 .B tzh_timecnt
 is zero or the time argument is less than the first transition time recorded
 in the file.
+.\" http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122906#47
+.\" Reviewed by upstream and rejected, May 2012
+.SH NOTES
+This manual page documents
+.I <tzfile.h>
+in the glibc source archive, see
+.IR timezone/tzfile.h .
+.PP
+It seems that timezone uses
+.B tzfile
+internally, but glibc refuses to expose it to userspace.  This is most
+likely because the standardised functions are more useful and
+portable, and actually documented by glibc.  It may only be in glibc
+just to support the non-glibc-maintained timezone data (which is
+maintained by some other entity).
+.\" End of patch
 .SS Version 2 format
 For version-2-format timezone files,
 the above header and data are followed by a second header and data,


-- 
<https://www.alejandro-colomar.es/>

Attachment: signature.asc
Description: PGP signature


[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