Package: man2html-base
Version: 1.6g-16
Severity: normal

While trying to fix new warnings in xlbiff's autopkgtests with groff 
1.24.0~rc1, I thought it would be simplest to use the .EX/.EE macros.  
groff_man(7) documents these as follows:

"Begin and end example.  After .EX, filling is disabled and a 
constant-width (monospaced) font is selected.  Calling .EE enables 
filling and restores the previous font."

(It goes on to mention some portability limitations, although only to 
very conservative systems.)

However, while testing this I discovered that man2html doesn't handle 
those macros well.  It seems that it turns .nf/.fi into <pre>...</pre>, 
which would imply that it should do the same for .EX/.EE (perhaps in 
addition to selecting a constant-width font, although I wasn't able to 
get man2html to do anything like that in my tests).  Here's a pair of 
test cases demonstrating the problem:

$ cat a.1
.TH A 1
.SH NAME
a \- test
.SH DESCRIPTION
.nf
text
.fi
$ man2html a.1
[...]
<H2>DESCRIPTION</H2>

<PRE>
text
</PRE>
[...]

$ cat b.1
.TH A 1
.SH NAME
a \- test
.SH DESCRIPTION
.EX
text
.EE
$ man2html b.1
[...]
<H2>DESCRIPTION</H2>


text
[...]

Thanks,

-- 
Colin Watson (he/him)                              [[email protected]]

-- System Information:
Debian Release: forky/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Foreign Architectures: arm64

Kernel: Linux 6.17.13+deb14-amd64 (SMP w/12 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, 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: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages man2html-base depends on:
ii  libc6  2.42-9

man2html-base recommends no packages.

Versions of packages man2html-base suggests:
ii  manpages      6.16-1
ii  manpages-dev  6.16-1

-- no debconf information

Reply via email to