mandoc(1) warning in tzfile(5) regarding //

[Alejandro Colomar]

Hi Paul, Branden,

I don't remember if we covered this bit in the discussions we had
a few months ago.  I'm seeing a couple of warnings from mandoc(1)
in tzfile(5):


$ make lint-man-mandoc V=1
LINT (mandoc)   tmp/lint/man5/tzfile.5.lint-man.mandoc.touch
! (mandoc -man -Tlint  man5/tzfile.5 2>&1 \
   | grep -v 'STYLE: lower case character in document title:' \
   | grep -v 'UNSUPP: ignoring macro in table:' \
   | grep -v 'WARNING: cannot parse date, using it verbatim: TH (date)' \
   | grep -v 'WARNING: empty block: UR' \
   ||:; \
) \
| grep '.' >&2
mandoc: man5/tzfile.5:15:19: WARNING: undefined escape, printing literally: \\
mandoc: man5/tzfile.5:15:10: WARNING: undefined escape, printing literally: \\
make: *** [lib/lint-man.mk:88: tmp/lint/man5/tzfile.5.lint-man.mandoc.touch] 
Error 1


The source is:

$ head man5/tzfile.5 -n20
.\" %%%LICENSE_START(PUBLIC_DOMAIN)
.\" This file is in the public domain, so clarified as of
.\" 1996-06-05 by Arthur David Olson <arthur_david_olson@nih.gov>.
.\" %%%LICENSE_END
.\"
.TH tzfile 5 2022-09-09 Linux "Linux Programmer's Manual"
.SH NAME
tzfile \- timezone information
.SH DESCRIPTION
.ie '\[lq]'' .ds lq \&"\"
.el .ds lq \[lq]\"
.ie '\[rq]'' .ds rq \&"\"
.el .ds rq \[rq]\"
.de q
\\$3\*(lq\\$1\*(rq\\$2
..
.ie \n(.g .ds - \f(CW-\fP
.el ds - \-
The timezone information files used by
.BR tzset (3)


Is this a limitation in mandoc(1)?  Should we change the source code?

Cheers,

Alex



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

OpenPGP_signature
Description: OpenPGP digital signature