local-lib5/lib/perl5/PPI/Statement/Unknown.pm

   1 package PPI::Statement::Unknown;
   2
   3 =pod
   4
   5 =head1 NAME
   6
   7 PPI::Statement::Unknown - An unknown or transient statement
   8
   9 =head1 INHERITANCE
  10
  11   PPI::Statement::Unknown
  12   isa PPI::Statement
  13       isa PPI::Node
  14           isa PPI::Element
  15
  16 =head1 DESCRIPTION
  17
  18 The C<PPI::Statement::Unknown> class is used primarily during the lexing
  19 process to hold elements that are known to be statement, but for which
  20 the exact C<type> of statement is as yet unknown, and requires further
  21 tokens in order to resolve the correct type.
  22
  23 They should not exist in a fully parse B<valid> document, and if any
  24 exists they indicate either a problem in Document, or possibly (by
  25 allowing it to get through unresolved) a bug in L<PPI::Lexer>.
  26
  27 =head1 METHODS
  28
  29 C<PPI::Statement::Unknown> has no additional methods beyond the
  30 default ones provided by L<PPI::Statement>, L<PPI::Node> and
  31 L<PPI::Element>.
  32
  33 =cut
  34
  35 use strict;
  36 use PPI::Statement ();
  37
  38 use vars qw{$VERSION @ISA};
  39 BEGIN {
  40         $VERSION = '1.206';
  41         @ISA     = 'PPI::Statement';
  42 }
  43
  44 # If one of these ends up in the final document,
  45 # we're pretty much screwed. Just call it a day.
  46 sub _complete () { 1 }
  47
  48 1;
  49
  50 =pod
  51
  52 =head1 SUPPORT
  53
  54 See the L<support section|PPI/SUPPORT> in the main module.
  55
  56 =head1 AUTHOR
  57
  58 Adam Kennedy E<lt>adamk@cpan.orgE<gt>
  59
  60 =head1 COPYRIGHT
  61
  62 Copyright 2001 - 2009 Adam Kennedy.
  63
  64 This program is free software; you can redistribute
  65 it and/or modify it under the same terms as Perl itself.
  66
  67 The full text of the license can be found in the
  68 LICENSE file included with this module.
  69
  70 =cut