#208967 docbook2man uses hyphens instead of minus signs

#208967#5
Date:
2003-09-06 16:09:55 UTC
From:
To:
See subject. In most cases and ALWAYS in option lists, the manpages are
meant to use minus signs ('\-' in groff syntax). But docbook2man prints
hyphens instead ('-'). This is very nasty, especially in Unicode
environments (copy&paste inpossible).

The severity is high because docbook2man is THE REASON for many broken
manpages in Debian.

MfG,
Eduard.

#208967#12
Date:
2005-08-18 12:31:25 UTC
From:
To:
severity 208967 grave
thanks

Christian, what about communicating with the bug reporters instead of
silently downgrading the bugs?

In fact this problems fscks the groff conversion in every Debian package
using Docbook sgml (from dh_make examples). How do your solution plans
look like? Do you have any? Do you need help?

Regards,
Eduard.

#208967#19
Date:
2005-09-01 22:50:15 UTC
From:
To:
severity 208967 normal
thanks

Nowadays, as of five months before you sent this mail, Debian groff
renders both - and \- using the same ASCII character even when using the
utf8 device, so speaking as the groff maintainer I can see no
justification for this bug to be grave. While the distinction has some
typographical importance (docbook2man's current output will occasionally
result in incorrect line breaks) and is therefore still a bug, it is
otherwise visible only in troff output such as PostScript.

groff (1.18.1.1-7) unstable; urgency=low

  * Too many fonts are missing the Unicode HYPHEN character, so I give up.
    Render "-" as HYPHEN-MINUS (ASCII 0x2D) by default. (Of course, manual
    pages using "-" when they should be using "\-" should still be fixed.)

#208967#26
Date:
2014-08-10 11:17:20 UTC
From:
To:
Hi,

Please find attached the debdiff patch that should solve both #208967
and #628751.

In short:  Current version of docbook2man's hyphen rendering makes
lintian complain about "hyphen-used-as-minus-sign". This patch renders
`-' as `\-' and `\-' as `\\\-', so we should have a correct output and
lintian not complaining again.

This should solve a big amount of the current
"hyphen-used-as-minus-sign" reports.

I wrote it as an NMU but I'd rather have it uploaded and integrated by
official maintainers.

Tested on module-init-tools (the oldstable version which uses sgml)
and it seems fine to me.
Also tested on gnome-shell-pomodoro I am currently using sgml man
pages with and it also works great!

Best,
Joseph

#208967#31
Date:
2014-08-10 11:17:20 UTC
From:
To:
Hi,

Please find attached the debdiff patch that should solve both #208967
and #628751.

In short:  Current version of docbook2man's hyphen rendering makes
lintian complain about "hyphen-used-as-minus-sign". This patch renders
`-' as `\-' and `\-' as `\\\-', so we should have a correct output and
lintian not complaining again.

This should solve a big amount of the current
"hyphen-used-as-minus-sign" reports.

I wrote it as an NMU but I'd rather have it uploaded and integrated by
official maintainers.

Tested on module-init-tools (the oldstable version which uses sgml)
and it seems fine to me.
Also tested on gnome-shell-pomodoro I am currently using sgml man
pages with and it also works great!

Best,
Joseph

#208967#36
Date:
2023-10-22 11:07:01 UTC
From:
To:
Hi!

Here's a ping, reminding that this bug still affects Debian Trixie
(currently unstable).  I have uncommented the workaround in my
/etc/groff/man.local, because as maintainer of the Linux man-pages, I do
want to be able to check if there are problems in my manual pages.  As a
consequence, I can't search (/) for options and things that contain '-'
in manual pages that have this bug.

There's a patch, so what else do we need to fix the bug?  Can the patch
be offered to upstream, please?

Thanks,
Alex