NetBSD Problem Report #57757

From tsutsui@ceres.dti.ne.jp  Wed Dec  6 16:59:22 2023
Return-Path: <tsutsui@ceres.dti.ne.jp>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 1D5E71A9238
	for <gnats-bugs@gnats.NetBSD.org>; Wed,  6 Dec 2023 16:59:22 +0000 (UTC)
Message-Id: <202312061659.3B6GxB1q005445@ceres.dti.ne.jp>
Date: Thu, 7 Dec 2023 01:59:11 +0900 (JST)
From: Izumi Tsutsui <tsutsui@ceres.dti.ne.jp>
Reply-To: tsutsui@ceres.dti.ne.jp
To: gnats-bugs@NetBSD.org
Subject: zdump(8) and zic(8) man pages broken in NetBSD 10.0_RC1
X-Send-Pr-Version: 3.95

>Number:         57757
>Category:       misc
>Synopsis:       zdump(8) and zic(8) man pages broken in NetBSD 10.0_RC1
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    kre
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Dec 06 17:00:00 +0000 2023
>Closed-Date:    Mon Jan 01 05:25:26 +0000 2024
>Last-Modified:  Mon Jan 01 05:25:26 +0000 2024
>Originator:     Izumi Tsutsui
>Release:        NetBSD 10.0_RC1
>Organization:
>Environment:
System: NetBSD mirage 10.0_RC1 NetBSD 10.0_RC1 (GENERIC) #0: Sun Nov 5 18:30:08 UTC 2023 mkrepro@mkrepro.NetBSD.org:/usr/src/sys/arch/i386/compile/GENERIC i386
Architecture: i386, maybe MI
Machine: i386
>Description:
On NetBSD 10.0_RC1 makemandb(8) complains:
>> makemandb: Error in indexing `/usr/share/man/man8/zic.8'
>> makemandb: Error in indexing `/usr/share/man/man8/zdump.8'
and actually both man pages seem broken.

>How-To-Repeat:
% uname -a
NetBSD mirage 10.0_RC1 NetBSD 10.0_RC1 (GENERIC) #0: Sun Nov  5 18:30:08 UTC 2023  mkrepro@mkrepro.NetBSD.org:/usr/src/sys/arch/i386/compile/GENERIC i386man 
% man zic
zic(8)                      System Manager's Manual                     zic(8)



The program reads text from the file(s) named on the command line and creates
the timezone information format (TZif) files specified in this input.  If a is
standard input is read.  Output version information and exit.  Output short
usage message and exit.  Output backward-compatibility data as specified by If
is generate additional data entries that work around potential bugs or
incompatibilities in older software, such as software that mishandles the
64-bit generated data.  If is keep the output files small; this can help check
for the bugs and incompatibilities.  The default is as software that
mishandles 64-bit data typically mishandles timestamps after the year 2038
anyway.  Also see the option for another way to alter output size.  Create
time conversion information files in the named directory rather than in the
standard directory named below.  Use the as local time.  will act as if the
input contained a link line of the form If is any already-existing link is
removed.  Read leap second information from the file with the given name.  If
this option is not used, no leap second information appears in output files.
 :

% man zdump
zdump(8)                    System Manager's Manual                   zdump(8)



The program prints the current time in each named on the command line.

OPTIONS
       Output version information and exit.  Output short usage message and
       exit.  Output a description of time intervals.  For each on the command
       line, output an interval-format description of the timezone.  See
       below.  Output a verbose description of time intervals.  For each on
       the command line, print the times at the two extreme time values, the
       times (if present) at and just beyond the boundaries of years that
       localtime(3) and gmtime(3) can represent, and the times both one second
       before and exactly at each detected time discontinuity.  Each line is
       followed by where is positive, zero, or negative depending on whether
       the given time is daylight saving time, standard time, or an unknown
 :

% nroff -mandoc /usr/share/man/man8/zic.8
/usr/share/man/man8/zic.8:312: warning [p 3, 8.0i]: can't break line
mdoc warning: .It macros in lists of type `column-list'
              require arguments (#676)
Usage: .It column_string [Ta [column_string ...] ] (#676)
mdoc warning: Using a macro as first argument cancels effect of .Sy (#678)
zic(8)                                                                  zic(8)
 :

% nroff -mandoc /usr/share/man/man8/zdump.8
Not a \-mdoc command: .SH (#29)
zdump(8)                                                              zdump(8)
 :

>Fix:
Check the above nroff(1) warnings?

---
Izumi Tsutsui

>Release-Note:

>Audit-Trail:
From: "Christos Zoulas" <christos@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57757 CVS commit: src/lib/libc/time
Date: Wed, 6 Dec 2023 15:01:44 -0500

 Module Name:	src
 Committed By:	christos
 Date:		Wed Dec  6 20:01:44 UTC 2023

 Modified Files:
 	src/lib/libc/time: zdump.8 zic.8

 Log Message:
 PR/57757: Izumi Tsutsui: Fix markup errors


 To generate a diff of this commit:
 cvs rdiff -u -r1.23 -r1.24 src/lib/libc/time/zdump.8
 cvs rdiff -u -r1.43 -r1.44 src/lib/libc/time/zic.8

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->needs-pullups
State-Changed-By: tsutsui@NetBSD.org
State-Changed-When: Fri, 29 Dec 2023 18:11:44 +0000
State-Changed-Why:
Fixed in HEAD, but on netbsd-10 zic.8 fixes conflict with tzcode 2023c updates.


From: Robert Elz <kre@munnari.OZ.AU>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/57757 (zdump(8) and zic(8) man pages broken in NetBSD 10.0_RC1)
Date: Sat, 30 Dec 2023 11:39:41 +0700

 I will make a suitable pullup request for -10 for this later today.

 kre

Responsible-Changed-From-To: misc-bug-people->kre
Responsible-Changed-By: kre@NetBSD.org
Responsible-Changed-When: Sat, 30 Dec 2023 04:42:07 +0000
Responsible-Changed-Why:
I will prepare a pullup for this.


State-Changed-From-To: needs-pullups->pending-pullups
State-Changed-By: kre@NetBSD.org
State-Changed-When: Sat, 30 Dec 2023 07:42:23 +0000
State-Changed-Why:
[pullup-10 #528]


From: "Martin Husemann" <martin@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57757 CVS commit: [netbsd-10] src/lib/libc/time
Date: Sun, 31 Dec 2023 12:34:49 +0000

 Module Name:	src
 Committed By:	martin
 Date:		Sun Dec 31 12:34:49 UTC 2023

 Modified Files:
 	src/lib/libc/time [netbsd-10]: zdump.8 zic.8

 Log Message:
 Pull up the following, requested by kre in ticket #528:

 	lib/libc/time/zic.8                             up to 1.49
 	lib/libc/time/zdump.8                           up to 1.25

 PR/57757: Izumi Tsutsui: Fix markup errors


 To generate a diff of this commit:
 cvs rdiff -u -r1.22 -r1.22.2.1 src/lib/libc/time/zdump.8
 cvs rdiff -u -r1.41 -r1.41.2.1 src/lib/libc/time/zic.8

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: pending-pullups->closed
State-Changed-By: tsutsui@NetBSD.org
State-Changed-When: Mon, 01 Jan 2024 05:25:26 +0000
State-Changed-Why:
Fixed in HEAD and pulled up to netbsd-10.


>Unformatted:

Home	PR Database Search