X-Git-Url: http://git.ieval.ro/?a=blobdiff_plain;f=lib%2FPod%2FConstants.pm;h=3e24fea847f0afe4b580adcccfe7c405f828e27e;hb=612aada29b8037a7040ecabd2ed8f3afa4402d49;hp=e3839fdf025673c595cfb5b0445ced0bd615cc44;hpb=49655cb6e58802c0fc6f013741c03968c9ab6f06;p=pod-constants.git diff --git a/lib/Pod/Constants.pm b/lib/Pod/Constants.pm index e3839fd..3e24fea 100644 --- a/lib/Pod/Constants.pm +++ b/lib/Pod/Constants.pm @@ -5,15 +5,14 @@ package Pod::Constants; -use 5.004; +use 5.006002; use strict; +use warnings; use base qw(Pod::Parser Exporter); -use Data::Dumper; use Carp; -use vars qw($VERSION); -$VERSION = 0.17; +our $VERSION = 0.17; # An ugly hack to go from caller() to the relevant parser state # variable @@ -25,13 +24,11 @@ sub end_input { return unless $parser->{active}; - print "Found end of $parser->{active}\n" if ($parser->{DEBUG}); + print "Found end of $parser->{active}\n" if $parser->{DEBUG}; my $whereto = $parser->{wanted_pod_tags}->{$parser->{active}}; - print "\$_ will be set to:\n---\n$parser->{paragraphs}\n---\n" - if ($parser->{DEBUG}); + print "\$_ will be set to:\n---\n$parser->{paragraphs}\n---\n" if $parser->{DEBUG}; - $parser->{paragraphs} =~ s/^\s*|\s*$//gs - if $parser->{trimmed_tags}->{$parser->{active}}; + $parser->{paragraphs} =~ s/^\s*|\s*$//gs if $parser->{trimmed_tags}->{$parser->{active}}; if (ref $whereto eq "CODE") { print "calling sub\n" if $parser->{DEBUG}; @@ -47,14 +44,12 @@ sub end_input { } elsif (ref $whereto eq "HASH") { print "inserting into hash\n" if $parser->{DEBUG}; # Oh, sorry, should I be in LISP101? - %$whereto = (map { map { s/^\s*|\s*$//g; $_ } - split /=>/, $_ } - grep m/^ - ( (?:[^=]|=[^>])+ ) # scan up to "=>" - => - ( (?:[^=]|=[^>])+ =? )# don't allow more "=>"'s - $/x, - split /\n/, $parser->{paragraphs}); + %$whereto = ( + map { map { s/^\s*|\s*$//g; $_ } split /=>/, $_ } grep m/^ + ( (?:[^=]|=[^>])+ ) # scan up to "=>" + => + ( (?:[^=]|=[^>])+ =? )# don't allow more "=>"'s + $/x, split /\n/, $parser->{paragraphs}); } else { die $whereto } $parser->{active} = undef; } @@ -65,50 +60,38 @@ sub command { $paragraph =~ s/(?:\r\n|\n\r)/\n/g; - print "Got command =$command, value=$paragraph\n" - if $parser->{DEBUG}; + print "Got command =$command, value=$paragraph\n" if $parser->{DEBUG}; $parser->end_input() if $parser->{active}; - my $does_she_want_it_sir; - my ($lookup); # first check for a catch-all for this command type if ( exists $parser->{wanted_pod_tags}->{"*$command"} ) { $parser->{paragraphs} = $paragraph; $parser->{active} = "*$command"; - $does_she_want_it_sir = "oohw"; - } elsif ($command =~ m/^(head\d+|item|(for|begin))$/) { if ( $2 ) { # if it's a "for" or "begin" section, the title is the # first word only - ($lookup, $parser->{paragraphs}) = - ($paragraph =~ m/^\s*(\S*)\s*(.*)/s); + ($lookup, $parser->{paragraphs}) = $paragraph =~ m/^\s*(\S*)\s*(.*)/s; } else { # otherwise, it's up to the end of the line - ($lookup, $parser->{paragraphs}) - = ($paragraph =~ m/^\s*(\S[^\n]*?)\s*\n(.*)$/s); + ($lookup, $parser->{paragraphs}) = $paragraph =~ m/^\s*(\S[^\n]*?)\s*\n(.*)$/s; } # Look for a match by name - if (defined $lookup - and exists $parser->{wanted_pod_tags}->{$lookup}) { + if (defined $lookup && exists $parser->{wanted_pod_tags}->{$lookup}) { print "Found $lookup\n" if ($parser->{DEBUG}); $parser->{active} = $lookup; - $does_she_want_it_sir = "suits you sir"; + } elsif ($parser->{DEBUG}) { + local $^W = 0; + print "Ignoring =$command $paragraph (lookup = $lookup)\n" } } else { # nothing print "Ignoring =$command (not known)\n" if $parser->{DEBUG}; } - - { - local $^W = 0; - print "Ignoring =$command $paragraph (lookup = $lookup)\n" - if (!$does_she_want_it_sir and $parser->{DEBUG}) - } } # Pod::Parser overloaded verbatim @@ -116,13 +99,10 @@ sub verbatim { my ($parser, $paragraph, $line_num) = @_; $paragraph =~ s/(?:\r\n|\n\r)/\n/g; - print("Got paragraph: $paragraph (" - .($parser->{active}?"using":"ignoring").")\n") - if $parser->{DEBUG}; + my $status = $parser->{active} ? "using" : "ignoring"; + print "Got paragraph: $paragraph ($status)\n" if $parser->{DEBUG}; - if (defined $parser->{active}) { - $parser->{paragraphs} .= $paragraph; - } + $parser->{paragraphs} .= $paragraph if defined $parser->{active} } # Pod::Parser overloaded textblock @@ -142,9 +122,7 @@ sub import { } $source_file ||= $0; - ( -f $source_file ) - or croak ("Cannot find source file (guessed $source_file) for" - ." package ".caller()); + croak "Cannot find source file (guessed $source_file) for package ".caller unless -f $source_file; # nasty tricks with the stack so we don't have to be silly with # caller() @@ -168,11 +146,9 @@ sub import_from_file { $parser->add_hook(@_); - print "Pod::Parser: DEBUG: Opening $filename for reading\n" - if $parser->{DEBUG}; + print "Pod::Parser: DEBUG: Opening $filename for reading\n" if $parser->{DEBUG}; my $fh = new IO::Handle; - open $fh, "<$filename" - or die ("cannot open $filename for reading; $!"); + open $fh, "<$filename" or die "cannot open $filename for reading; $!"; $parser->parse_from_filehandle($fh, \*STDOUT); @@ -181,12 +157,10 @@ sub import_from_file { sub add_hook { my $parser; - if ( UNIVERSAL::isa($_[0], __PACKAGE__) ) { + if (UNIVERSAL::isa($_[0], __PACKAGE__)) { $parser = shift; } else { - $parser = $parsers{caller()} - or die("add_hook called, but don't know what for - " - ."caller = ".caller()); + $parser = $parsers{caller()} or die "add_hook called, but don't know what for - caller = ".caller; } while (my ($pod_tag, $var) = splice @_, 0, 2) { #print "$pod_tag: $var\n"; @@ -199,15 +173,11 @@ sub add_hook { #%wanted_pod_tags{@tags} } else { if ((ref $var) =~ /^(?:SCALAR|CODE|ARRAY|HASH)$/) { - print "Will look for $pod_tag.\n" - if ($parser->{DEBUG}); + print "Will look for $pod_tag.\n" if $parser->{DEBUG}; $parser->{wanted_pod_tags}->{$pod_tag} = $var; - $parser->{trimmed_tags}->{$pod_tag} = 1 - if $parser->{trim_next}; + $parser->{trimmed_tags}->{$pod_tag} = 1 if $parser->{trim_next}; } else { - die ("Sorry - need a reference to import POD " - ."sections into, not the scalar value $var" - ." importing $pod_tag into ".caller()); + die "Sorry - need a reference to import POD sections into, not the scalar value $var" } } } @@ -218,9 +188,7 @@ sub delete_hook { if ( UNIVERSAL::isa($_[0], __PACKAGE__) ) { $parser = shift; } else { - $parser = $parsers{caller()} - or die("delete_hook called, but don't know what for - " - ."caller = ".caller()); + $parser = $parsers{caller()} or die "delete_hook called, but don't know what for - caller = ".caller; } while ( my $label = shift ) { delete $parser->{wanted_pod_tags}->{$label}; @@ -228,15 +196,6 @@ sub delete_hook { } } -BEGIN { - Pod::Constants->import - ( - SYNOPSIS => sub { - eval pop @{[ grep /^\s*\$VERSION/, split /\n/, $_ ]} - } - ) -}; - 1.4142; __END__ @@ -248,7 +207,7 @@ Pod::Constants - Include constants from POD =head1 SYNOPSIS - use vars qw($myvar $VERSION @myarray $html %myhash); + our ($myvar, $VERSION, @myarray, $html, %myhash); use Pod::Constants -trim => 1, 'Pod Section Name' => \$myvar, @@ -477,7 +436,7 @@ method seems to break dh-make-perl. =cut - use vars qw($VERSION); + our $VERSION; use Pod::Constants -trim => 1, 'MODULE RELEASE' => sub { ($VERSION) = m/(\d+\.\d+) or die };