[Bug 290801] date(1) does not render correctly on man.freebsd.org

From: <bugzilla-noreply_at_freebsd.org>
Date: Wed, 05 Nov 2025 02:54:10 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=290801

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

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

> <p style="margin-left:9%; margin-top: 1em">The
> <b>&minus;I</b> flag was added in FreeBSD&nbsp;12.0.</p>
> 
> <p style="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  

> 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

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