Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 05 Nov 2025 02:54:10 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 290801] date(1) does not render correctly on man.freebsd.org
Message-ID:  <bug-290801-9-YPd6YTZJsz@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-290801-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-290801-9@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D290801

--- Comment #4 from B.S. <bigsneaky@duck.com> ---
I believe man.freebsd.org uses groff(1) (version 1.23.0?) which struggles w=
ith
%N presumably as it is a references & citations macro for issue number: see
https://man.freebsd.org/cgi/man.cgi?query=3Dgroff_mdoc=20

To replicate the website's History section error: $ groff -mdoc -T html dat=
e.1

> <p style=3D"margin-left:9%; margin-top: 1em">The
> <b>&minus;I</b> flag was added in FreeBSD&nbsp;12.0.</p>
>=20
> <p style=3D"margin-left:9%; margin-top: 1em">The
> &lsquo;conversion specification was added in FreeBSD&rsquo;

Or in plain ASCII, generating an mdoc warning: $ groff -a -mdoc=20=20

> The <->I flag was added in FreeBSD 12.0.
> mdoc warning: Using a macro as first argument cancels effect of .Li (#618)
> Usage: .%N issue_number ... (#618)
> The <oq>conversion specification was added in FreeBSD<cq>

While mandoc(1) generates the desired html, it still warns with -Tlint:

$ mandoc -Tlint date.1

> mandoc: date.1:146:8: WARNING: skipping empty macro: No
> mandoc: date.1:331:5: WARNING: macro neither callable nor escaped: %N
> mandoc: date.1:594:5: WARNING: macro neither callable nor escaped: %N
> mandoc: date.1:597:5: WARNING: macro neither callable nor escaped: %N
> mandoc: date.1:618:5: WARNING: macro neither callable nor escaped: %N
> mandoc: date.1:198:2: STYLE: useless macro: Tn
> mandoc: date.1:511:2: STYLE: useless macro: Tn

--=20
You are receiving this mail because:
You are on the CC list for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-290801-9-YPd6YTZJsz>