minor bug in dumping blessed subrefs
[p5sagit/p5-mst-13.2.git] / pod / pod2text.PL
index caa6ec4..94516c3 100644 (file)
 #!/usr/local/bin/perl
 
-$SCREEN = ($ARGV[0] =~ /^-(\d+)/ && (shift, $1))
-       || ($ENV{TERMCAP} =~ /co#(\d+)/)[0]
-       ||  $ENV{COLUMNS}       
-       || (`stty -a 2>/dev/null` =~ /(\d+) columns/)[0] 
-       || 72;
+use Config;
+use File::Basename qw(&basename &dirname);
+use Cwd;
 
-$/ = "";
+# List explicitly here the variables you want Configure to
+# generate.  Metaconfig only looks for shell variables, so you
+# have to mention them as if they were shell variables, not
+# %Config entries.  Thus you write
+#  $startperl
+# to ensure Configure will look for $Config{startperl}.
 
-$FANCY = 0;
+# This forces PL files to create target in same directory as PL file.
+# This is so that make depend always knows where to find PL derivatives.
+$origdir = cwd;
+chdir dirname($0);
+$file = basename($0, '.PL');
+$file .= '.com' if $^O eq 'VMS';
 
-$cutting = 1;
-$DEF_INDENT = 4;
-$indent = $DEF_INDENT;
-$needspace = 0;
+open OUT,">$file" or die "Can't create $file: $!";
 
-POD_DIRECTIVE: while (<>) {
-    if ($cutting) {
-       next unless /^=/;
-       $cutting = 0;
-    }
-    1 while s{^(.*?)(\t+)(.*)$}{
-       $1 
-       . (' ' x (length($2) * 8 - length($1) % 8))
-       . $3
-    }me;
-    # Translate verbatim paragraph
-    if (/^\s/) {
-       $needspace = 1;
-       output($_);
-       next;
-    }
+print "Extracting $file (with variable substitutions)\n";
 
-sub prepare_for_output {
+# In this section, perl variables will be expanded during extraction.
+# You can use $Config{...} to use Configure variables.
 
-    s/\s*$/\n/;
-    &init_noremap;
+print OUT <<"!GROK!THIS!";
+$Config{startperl}
+    eval 'exec $Config{perlpath} -S \$0 \${1+"\$@"}'
+       if \$running_under_some_shell;
+!GROK!THIS!
 
-    # need to hide E<> first; they're processed in clear_noremap
-    s/(E<[^<>]+>)/noremap($1)/ge;
-    $maxnest = 10;
-    while ($maxnest-- && /[A-Z]</) {
-       unless ($FANCY) { 
-           s/C<(.*?)>/`$1'/g;
-       } else {
-           s/C<(.*?)>/noremap("E<lchevron>${1}E<rchevron>")/ge;
-       }
-        # s/[IF]<(.*?)>/italic($1)/ge;  
-        s/I<(.*?)>/*$1*/g;  
-        # s/[CB]<(.*?)>/bold($1)/ge;
-       s/X<.*?>//g;
-       # LREF: a manpage(3f) 
-       s:L<([a-zA-Z][^\s\/]+)(\([^\)]+\))?>:the $1$2 manpage:g;
-       # LREF: an =item on another manpage
-       s{
-           L<
-               ([^/]+)
-               /
-               (
-                   [:\w]+
-                   (\(\))?
-               )
-           >
-       } {the "$2" entry in the $1 manpage}gx;
+# In the following, perl variables are not expanded during extraction.
 
-       # LREF: an =item on this manpage
-       s{
-          ((?:
-           L<
-               /
-               (
-                   [:\w]+
-                   (\(\))?
-               )
-           >
-           (,?\s+(and\s+)?)?
-         )+)
-       } { internal_lrefs($1) }gex;
+print OUT <<'!NO!SUBS!';
 
-       # LREF: a =head2 (head1?), maybe on a manpage, maybe right here
-       # the "func" can disambiguate
-       s{
-           L<
-               (?:
-                   ([a-zA-Z]\S+?) / 
-               )?
-               "?(.*?)"?
-           >
-       }{
-           do {
-               $1      # if no $1, assume it means on this page.
-                   ?  "the section on \"$2\" in the $1 manpage"
-                   :  "the section on \"$2\""
-           } 
-       }gex;
+use Pod::Text;
 
-        s/[A-Z]<(.*?)>/$1/g;
-    }
-    clear_noremap(1);
+if(@ARGV) {
+       pod2text($ARGV[0]);
+} else {
+       pod2text("<&STDIN");
 }
 
-    &prepare_for_output;
-
-    if (s/^=//) {
-       # $needspace = 0;               # Assume this.
-       # s/\n/ /g;
-       ($Cmd, $_) = split(' ', $_, 2);
-       # clear_noremap(1);
-       if ($Cmd eq 'cut') {
-           $cutting = 1;
-       }
-       elsif ($Cmd eq 'head1') {
-           makespace();
-           print;
-           #print uc($_);
-       }
-       elsif ($Cmd eq 'head2') {
-           makespace();
-           # s/(\w+)/\u\L$1/g;
-           #print ' ' x $DEF_INDENT, $_;
-           # print "\xA7";
-           s/(\w)/\xA7 $1/ if $FANCY;
-           print ' ' x ($DEF_INDENT/2), $_, "\n";
-       }
-       elsif ($Cmd eq 'over') {
-           push(@indent,$indent);
-           $indent += ($_ + 0) || $DEF_INDENT;
-       }
-       elsif ($Cmd eq 'back') {
-           $indent = pop(@indent);
-           warn "Unmatched =back\n" unless defined $indent;
-           $needspace = 1;
-       } 
-       elsif ($Cmd eq 'item') {
-           makespace();
-           # s/\A(\s*)\*/$1\xb7/ if $FANCY;
-           # s/^(\s*\*\s+)/$1 /;
-           {
-               if (length() + 3 < $indent) { 
-                   my $paratag = $_;
-                   $_ = <>;
-                   if (/^=/) {  # tricked!
-                       local($indent) = $indent[$#index - 1] || $DEF_INDENT;
-                       output($paratag);
-                       redo POD_DIRECTIVE;
-                   } 
-                   &prepare_for_output;
-                   IP_output($paratag, $_);
-               } else {
-                   local($indent) = $indent[$#index - 1] || $DEF_INDENT;
-                   output($_);
-               }
-           }
-       } 
-       else {
-           warn "Unrecognized directive: $Cmd\n";
-       }
-    }
-    else {
-       # clear_noremap(1);
-       makespace();
-       output($_, 1);
-    }
-}
-
-#########################################################################
-
-sub makespace {
-    if ($needspace) {
-       print "\n";
-       $needspace = 0;
-    } 
-} 
-
-sub bold {
-    my $line = shift;
-    $line =~ s/(.)/$1\b$1/g;
-    return $line;
-} 
-
-sub italic {
-    my $line = shift;
-    $line =~ s/(.)/_\b$1/g;
-    return $line;
-} 
-
-sub IP_output {
-    local($tag, $_) = @_;
-    local($tag_indent) = $indent[$#index - 1] || $DEF_INDENT;
-    $tag_cols = $SCREEN - $tag_indent;
-    $cols = $SCREEN - $indent;
-    $tag =~ s/\s*$//;
-    s/\s+/ /g;
-    s/^ //;
-    $str = "format STDOUT = \n" 
-       . (" " x ($tag_indent)) 
-       . '@' . ('<' x ($indent - $tag_indent - 1))
-       . "^" .  ("<" x ($cols - 1)) . "\n" 
-       . '$tag, $_' 
-       . "\n~~"
-       . (" " x ($indent-2)) 
-       . "^" .  ("<" x ($cols - 5)) . "\n"
-       . '$_' . "\n\n.\n1";
-    #warn $str; warn "tag is $tag, _ is $_";
-    eval $str || die;
-    write;
-} 
-
-sub output {
-    local($_, $reformat) = @_;
-    if ($reformat) {
-       $cols = $SCREEN - $indent;
-       s/\s+/ /g;
-       s/^ //;
-       $str = "format STDOUT = \n~~" 
-           . (" " x ($indent-2)) 
-           . "^" .  ("<" x ($cols - 5)) . "\n"
-           . '$_' . "\n\n.\n1";
-       eval $str || die;
-       write;
-    } else {
-       s/^/' ' x $indent/gem;
-       s/^\s+\n$/\n/gm;
-       print;
-    }
-} 
-
-sub noremap {
-    local($thing_to_hide) = shift;
-    $thing_to_hide =~ tr/\000-\177/\200-\377/;
-    return $thing_to_hide;
-} 
-
-sub init_noremap {
-    die "unmatched init" if $mapready++;
-    if ( /[\200-\377]/ ) {
-       warn "hit bit char in input stream";
-    } 
-} 
-
-sub clear_noremap {
-    my $ready_to_print = $_[0];
-    die "unmatched clear" unless $mapready--;
-    tr/\200-\377/\000-\177/;
-    # now for the E<>s, which have been hidden until now
-    # otherwise the interative \w<> processing would have
-    # been hosed by the E<gt>
-    s {
-           E<  
-           ( [A-Za-z]+ )       
-           >   
-    } { 
-        do {   
-            defined $HTML_Escapes{$1}
-               ? do { $HTML_Escapes{$1} }
-               : do {
-                   warn "Unknown escape: $& in $_";
-                   "E<$1>";
-               } 
-        } 
-    }egx if $ready_to_print;
-} 
-
-sub internal_lrefs {
-    local($_) = shift;
-    s{L</([^>]+)>}{$1}g;
-    my(@items) = split( /(?:,?\s+(?:and\s+)?)/ );
-    my $retstr = "the ";
-    my $i;
-    for ($i = 0; $i <= $#items; $i++) {
-       $retstr .= "C<$items[$i]>";
-       $retstr .= ", " if @items > 2 && $i != $#items;
-       $retstr .= " and " if $i+2 == @items;
-    } 
-
-    $retstr .= " entr" . ( @items > 1  ? "ies" : "y" )
-           .  " elsewhere in this document ";
-
-    return $retstr;
-
-} 
-
-BEGIN {
-
-%HTML_Escapes = (
-    'amp'      =>      '&',    #   ampersand
-    'lt'       =>      '<',    #   left chevron, less-than
-    'gt'       =>      '>',    #   right chevron, greater-than
-    'quot'     =>      '"',    #   double quote
-
-    "Aacute"   =>      "\xC1", #   capital A, acute accent
-    "aacute"   =>      "\xE1", #   small a, acute accent
-    "Acirc"    =>      "\xC2", #   capital A, circumflex accent
-    "acirc"    =>      "\xE2", #   small a, circumflex accent
-    "AElig"    =>      "\xC6", #   capital AE diphthong (ligature)
-    "aelig"    =>      "\xE6", #   small ae diphthong (ligature)
-    "Agrave"   =>      "\xC0", #   capital A, grave accent
-    "agrave"   =>      "\xE0", #   small a, grave accent
-    "Aring"    =>      "\xC5", #   capital A, ring
-    "aring"    =>      "\xE5", #   small a, ring
-    "Atilde"   =>      "\xC3", #   capital A, tilde
-    "atilde"   =>      "\xE3", #   small a, tilde
-    "Auml"     =>      "\xC4", #   capital A, dieresis or umlaut mark
-    "auml"     =>      "\xE4", #   small a, dieresis or umlaut mark
-    "Ccedil"   =>      "\xC7", #   capital C, cedilla
-    "ccedil"   =>      "\xE7", #   small c, cedilla
-    "Eacute"   =>      "\xC9", #   capital E, acute accent
-    "eacute"   =>      "\xE9", #   small e, acute accent
-    "Ecirc"    =>      "\xCA", #   capital E, circumflex accent
-    "ecirc"    =>      "\xEA", #   small e, circumflex accent
-    "Egrave"   =>      "\xC8", #   capital E, grave accent
-    "egrave"   =>      "\xE8", #   small e, grave accent
-    "ETH"      =>      "\xD0", #   capital Eth, Icelandic
-    "eth"      =>      "\xF0", #   small eth, Icelandic
-    "Euml"     =>      "\xCB", #   capital E, dieresis or umlaut mark
-    "euml"     =>      "\xEB", #   small e, dieresis or umlaut mark
-    "Iacute"   =>      "\xCD", #   capital I, acute accent
-    "iacute"   =>      "\xED", #   small i, acute accent
-    "Icirc"    =>      "\xCE", #   capital I, circumflex accent
-    "icirc"    =>      "\xEE", #   small i, circumflex accent
-    "Igrave"   =>      "\xCD", #   capital I, grave accent
-    "igrave"   =>      "\xED", #   small i, grave accent
-    "Iuml"     =>      "\xCF", #   capital I, dieresis or umlaut mark
-    "iuml"     =>      "\xEF", #   small i, dieresis or umlaut mark
-    "Ntilde"   =>      "\xD1",         #   capital N, tilde
-    "ntilde"   =>      "\xF1",         #   small n, tilde
-    "Oacute"   =>      "\xD3", #   capital O, acute accent
-    "oacute"   =>      "\xF3", #   small o, acute accent
-    "Ocirc"    =>      "\xD4", #   capital O, circumflex accent
-    "ocirc"    =>      "\xF4", #   small o, circumflex accent
-    "Ograve"   =>      "\xD2", #   capital O, grave accent
-    "ograve"   =>      "\xF2", #   small o, grave accent
-    "Oslash"   =>      "\xD8", #   capital O, slash
-    "oslash"   =>      "\xF8", #   small o, slash
-    "Otilde"   =>      "\xD5", #   capital O, tilde
-    "otilde"   =>      "\xF5", #   small o, tilde
-    "Ouml"     =>      "\xD6", #   capital O, dieresis or umlaut mark
-    "ouml"     =>      "\xF6", #   small o, dieresis or umlaut mark
-    "szlig"    =>      "\xDF",         #   small sharp s, German (sz ligature)
-    "THORN"    =>      "\xDE", #   capital THORN, Icelandic 
-    "thorn"    =>      "\xFE", #   small thorn, Icelandic 
-    "Uacute"   =>      "\xDA", #   capital U, acute accent
-    "uacute"   =>      "\xFA", #   small u, acute accent
-    "Ucirc"    =>      "\xDB", #   capital U, circumflex accent
-    "ucirc"    =>      "\xFB", #   small u, circumflex accent
-    "Ugrave"   =>      "\xD9", #   capital U, grave accent
-    "ugrave"   =>      "\xF9", #   small u, grave accent
-    "Uuml"     =>      "\xDC", #   capital U, dieresis or umlaut mark
-    "uuml"     =>      "\xFC", #   small u, dieresis or umlaut mark
-    "Yacute"   =>      "\xDD", #   capital Y, acute accent
-    "yacute"   =>      "\xFD", #   small y, acute accent
-    "yuml"     =>      "\xFF", #   small y, dieresis or umlaut mark
-
-    "lchevron" =>      "\xAB", #   left chevron (double less than)
-    "rchevron" =>      "\xBB", #   right chevron (double greater than)
-);
-}
+!NO!SUBS!
 
+close OUT or die "Can't close $file: $!";
+chmod 0755, $file or die "Can't reset permissions for $file: $!\n";
+exec("$Config{'eunicefix'} $file") if $Config{'eunicefix'} ne ':';
+chdir $origdir;