[Documentation] Debian's lintian generates a lot of lintian warnings on manpages

[michel-slm]

Describe the bug
Debian's dropbox package is automatically linted, and it produces a lot of warnings:

https://udd.debian.org/lintian/?packages=distrobox

To Reproduce

• clone https://salsa.debian.org/michel/distrobox
• rebuild:

dpkg-source -b .
pbuilder-dist sid build ../distrobox*.dsc
lintian ~/pbuilder/sid_result/distrobox*_all.deb --tag-display-limit 0

Expected behavior
no bad-whatis-entry or groff-message warnings

Logs
Run the commands with --verbose and post the log here as a file upload
Attach also the output of podman logs or docker logs, possibly with --latest flag
distrobox-lintian.txt

Desktop (please complete the following information):

• Are you using podman or docker? N/A
• Which version or podman or docker? N/A
• Which version of distrobox? 1.3.1

Additional context
Add any other context about the problem here.

[michel-slm]

I see the same in the related Ubuntu packages in the PPA

[michel-slm]

related: dotnet/sdk#25709

[michel-slm]

after 2a26ab6 - and the automatically generated manpages in e8c0cfc -- I'm still getting the same lintian warnings

Comparing e.g. distrobox-create.1 with genisoimage.1, I suspect the NAME section still looks wrong

distrobox-create.1:

.SH NAME
.IP
.nf
\f[C]
distrobox create
distrobox-create
\f[R]
.fi

genisoimage

.SH NAME
genisoimage \- create ISO9660/Joliet/HFS filesystem with optional Rock Ridge attributes
.\" ----------------------------------------

[michel-slm]

better repro, use lexgrog:

distrobox/man/man1 on  docs-add-name-section 
⬢ [debian:testing-backports] ❯ lexgrog -d distrobox-create.1
ruid=1001, euid=1001
rgid=1001, egid=1001
++priv_drop_count = 1

ult_src: File distrobox-create.1 in mantree .
++priv_drop_count = 2
--priv_drop_count = 1
++priv_drop_count = 2
--priv_drop_count = 1
record = 'f[C] distrobox create distrobox-createf[R]'
distrobox-create.1: parse failed

distrobox/man/man1 on  docs-add-name-section 
⬢ [debian:testing-backports] ❯ lexgrog -d distrobox.1 
ruid=1001, euid=1001
rgid=1001, egid=1001
++priv_drop_count = 1

ult_src: File distrobox.1 in mantree .
++priv_drop_count = 2
--priv_drop_count = 1
++priv_drop_count = 2
--priv_drop_count = 1
record = 'f[C] distrobox create distrobox-createf[R]'
distrobox.1: parse failed

[89luca89]

@michel-slm
thanks a lot for the investigation!
so what do you suggest to make it play nicely with the auto-gen?