Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 25 Nov 2022 00:54:36 +0000
From:      bugzilla-noreply@freebsd.org
To:        ports-bugs@FreeBSD.org
Subject:   [Bug 267908] audio/sox: man page broken badly.
Message-ID:  <bug-267908-7788-GbBTziwXTB@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-267908-7788@https.bugs.freebsd.org/bugzilla/>
References:  <bug-267908-7788@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=3D267908

--- Comment #5 from Dan Nelson <dnelson@allantgroup.com> ---
Created attachment 238323
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D238323&action=
=3Dedit
work around manpage formatting issues

I'm falling deeper into the roff rabbit hole.

Putting manual blanks in every place that EE/EX is used feels like a hack..=
.  I
tried putting the blanks inside the definitions of the two blocks at the to=
p of
the manpage, but it seems that those two macro definitions are completely
unused.  It's as if the default EE/EX macros are overriding the ones define=
d in
the manpage.  Globally renaming the macros to something else makes them wor=
k,
and they include blank lines already.


As for the warnings, I'm running 13.1-STABLE from October, and the man wrap=
per
decides to call groff because it runs "mandoc -Tlint -Wunsupp" as a test, a=
nd
if that fails it calls groff.  The test fails with these messages:

mandoc: <stdin>:3535:2: UNSUPP: ignoring macro in table: B dcshift
mandoc: <stdin>:3549:2: UNSUPP: ignoring macro in table: B vol
mandoc: <stdin>:3552:2: UNSUPP: ignoring macro in table: B Clipping

Replacing the B markup macros with \fB..\fR font-selection escapes lets man=
doc
run without warnings.


The attached patches address both problems.

--=20
You are receiving this mail because:
You are the assignee for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-267908-7788-GbBTziwXTB>