Can you report this upstream at https://mandoc.bsd.lv/contact.html please?
On Tue, 17 Jan 2023 at 16:18, Colin Watson <cjwat...@debian.org> wrote: > 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 [cjwat...@debian.org] > -- Best regards, Michael
