Re: missing E<> POD directive in perlpod.pod
Roderick Schertler [Thu, 19 Dec 1996 15:30:43 +0000 (10:30 -0500)]
On Thu, 19 Dec 1996 07:53:26 +0100 (MET), sb@sdm.de (Steffen Beyer) said:
>
> If only E<> was mentioned in perlpod.pod! :-)

Thanks for the heads up, it's already in the next perlpod.pod.

    E<escape>   An HTML escape
    E<lt> A literal <
    E<gt> A literal >
    (these are optional except in other interior
     sequences and when preceded by a capital letter)
    E<nnn> Character number nnn.

Porters, note this doesn't actually mention that the HTML entity names
are valid, here's a patch.  It also change E<nnn> to use only one n, as
none of the translators care how many digits the number has.  It also
fixes numeric escapes in pod2html.

p5p-msgid: <pzwwueimak.fsf@eeyore.ibcinc.com>

pod/perlpod.pod
pod/pod2html.PL

index dcf615d..9fb6b4e 100644 (file)
@@ -108,7 +108,9 @@ here and in commands:
                    E<gt>               A literal >
                    (these are optional except in other interior
                     sequences and when preceded by a capital letter)
-                   E<nnn>              Character number nnn.
+                   E<n>                Character number n
+                   E<html>             Some non-numeric HTML entity, such
+                                       as E<Agrave>
 
 =back
 
index b41e0c3..cc21b07 100644 (file)
@@ -323,6 +323,7 @@ sub scan_thing{           # scan a chunk for later references
     my($cmd,$title,$pod) = @_;
     $_ = $title;
     s/\n$//;
+    s/E<(\d+)>/&#$1;/g;
     s/E<(.*?)>/&$1;/g;
     # remove any formatting information for the headers
     s/[SFCBI]<(.*?)>/$1/g;         
@@ -507,6 +508,7 @@ sub pre_escapes {  # twiddle these, and stay up late  :-)
        s/&/noremap("&amp;")/ge;
        s/<</noremap("&lt;&lt;")/eg;
        s/([^ESIBLCF])</$1\&lt\;/g;
+       s/E<(\d+)>/\&#$1\;/g;                     # embedded numeric special
        s/E<([^\/][^<>]*)>/\&$1\;/g;              # embedded special
     }
 }