Bug#491578: manpage wrapping warnings should be ignored if the line contains an URL
Damyan Ivanov <dmn@debian.org> writes:
> Package: lintian
> Version: 1.24.2
> Severity: normal
> Tags: patch
>
> Attached is a patch that makes checks/manpages not issue
> manpage-has-errors-from-man if the line in question contains an URL.
Yup, I agree; I think this is the right thing to do.
> * make pod2man not disable hyphenation.
> There is a comment in the generated manpage saying that hyphenation is
> disabled because it often doesn't work well with technical texts. This
> is a bit questionable, I guess, and if you think this is a mistake,
> please reassign the bug to 'perl'.
As the upstream maintainer of pod2man, I stand by that judgement (and was
the one who added that and the comment in the first place). Without
disabling hyphenation, man tends to do things like hyphenate in the middle
of code samples or long options, which is horribly confusing.
> * patch upstream sources, hand-wrapping long URLs.
Hand-wrapping POD is definitely a bad idea.
I think this is the best solution.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: