Package: cmark
Severity: normal
Tags: upstream
Version: 0.30.2-6+b2

Hi,

When generating manpages from markdown syntax, cmark uses "\f[C]" to indicate
code (represented between backticks in the markdown source).  (It likely uses
this too for code blocks and blockquotes.) This is not valid roff: 'C' is not a
groff font name.  I believe the EX (Example begin) and EE (Example end) macros
would be more suitable: "Example regions are useful for formatting code", see
groff_man(7).  Lots of more details are available from
https://savannah.gnu.org/bugs/index.php?64594 'bug #64594: [troff] "warning:
cannot select font 'C'"' .

The problem can be reproduced by running:

 % echo "`foo`" >foo.md

 % cmark -t man foo.md >foo.1

 % groff -t -e -mandoc -Tutf8 foo.1 >/dev/null
 troff:foo.1:2: warning: cannot select font 'C'

 % cat foo.1
 .PP
 \f[C]foo\f[]

I've seen the warning emitted with man-db 2.13.0-1 and groff 1.23.0-7
(man-db 2.11.2 and groff 1.22.4 do _not_ emit the warning).

See also #1076648: "aephea: causes groff warning "cannot select font 'C'" when
using \verbatim{ } or \tt{ }" .

Thanks, Bye,

Joost

Reply via email to