Package: mandoc
Version: 1.14.6-1+b1
Severity: normal
I was in the process of referring a user to
https://manpages.debian.org/bullseye/germinate/germinate.1.en.html, and
I happened to notice that some things are rendered oddly. This input:
The contents of the Ubuntu distribution, and others, are managed by means of
.Em seeds .
... is rendered as follows by "mandoc -Thtml":
<p class="Pp">The contents of the Ubuntu distribution, and others, are managed
by means of
<a class="permalink" href="#seeds"><i class="Em" id="seeds">seeds</i></a>.
Perhaps there's some reason for this, but it looks odd - the effect is a
hyperlink to the same place in the document - and it seems to deviate
from the documented semantics of .Em. mdoc(7) says:
Em word ...
Request an italic font. If the output device does not provide that,
underline.
This is most often used for stress emphasis (not to be confused with
importance, see Sy). In the rare cases where none of the semantic
markup macros fit, it can also be used for technical terms and
placeholders, except that for syntax elements, Sy and Ar are
preferred, respectively.
Examples:
Selected lines are those
.Em not
matching any of the specified patterns.
Some of the functions use a
.Em hold space
to save the pattern space for subsequent retrieval.
See also No, Ql, and Sy.
... while groff_mdoc(7) says:
Emphasis Macro
Text may be stressed or emphasized with the ‘.Em’ macro. The usual font
for emphasis is italic.
Usage: .Em ⟨argument⟩ ...
.Em does not does not
.Em exceed 1024 . exceed 1024.
.Em vide infra ) ) , vide infra)),
The default width is 10n.
Maybe this is just an accidental consequence of something else and can
be fixed; I don't see a reason why we need more than italic-font
emphasis here. But if it's deliberate, please could there at least be a
portable way to suppress the spurious hyperlinks?
-- System Information:
Debian Release: bookworm/sid
APT prefers unstable
APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 5.19.0-26-generic (SMP w/4 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_FIRMWARE_WORKAROUND,
TAINT_OOT_MODULE
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8),
LANGUAGE=en_GB:en
Shell: /bin/sh linked to /usr/bin/dash
Init: unable to detect
Versions of packages mandoc depends on:
ii libc6 2.36-8
ii zlib1g 1:1.2.13.dfsg-1
mandoc recommends no packages.
mandoc suggests no packages.
-- no debconf information
Thanks,
--
Colin Watson [[email protected]]
