pod2man produces broken pages

Georg Moritz <gm@mgm-net.de> wrote:

>A single quote in a pod file beginning a line, translated to \*(L'
>by B<pod2man> lets the formatter choke, i.e. the line is (in the best
>case) treated as a comment.

I think it would be better to leave the pods alone, and fix pod2man:

p5p-msgid: 1997May25.192350.2055977@hmivax.humgen.upenn.edu
private-msgid: 199705310447.AAA15721@obelix.cs.Buffalo.EDU
Signed-off-by: Hans Mulder <hansm@icgned.nl>

diff --git a/pod/pod2man.PL b/pod/pod2man.PL
index cd14ce2..b0f8b1b 100644 (file)
--- a/pod/pod2man.PL
+++ b/pod/pod2man.PL
@@ -705,6 +705,9 @@ while (<>) {
 
        # trofficate backslashes; must do it before what happens below
        s/\\/noremap('\\e')/ge;
+       # protect leading periods and quotes against *roff
+       # mistaking them for directives
+       s/^(?:[A-Z]<)?[.']/\\&$&/gm;
 
        # first hide the escapes in case we need to
        # intuit something and get it wrong due to fmting