NetBSD-Bugs archive

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

misc/57757: zdump(8) and zic(8) man pages broken in NetBSD 10.0_RC1



>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:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Dec 06 17:00:00 +0000 2023
>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@localhost:/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@localhost:/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



Home | Main Index | Thread Index | Old Index