The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Pod::LOL - parse Pod into a list of lists (LOL)

VERSION

Version 0.13

SYNOPSIS

   % cat my.pod

   =head1 NAME

   Pod::LOL - parse Pod into a list of lists (LOL)


   % perl -MPod::LOL -MData::Dumper -e 'print Dumper( Pod::LOL->new_root("my.pod") )'

Returns:

   [
      [
         "head1",
         "NAME"
      ],
      [
         "Para",
         "Pod::LOL - parse Pod into a list of lists (LOL)"
      ],
   ]

DESCRIPTION

This class may be of interest to anyone writing a pod parser.

This module takes pod (as a file) and returns a list of lists (LOL) structure.

This is a subclass of Pod::Simple and inherits all of its methods.

SUBROUTINES/METHODS

new_root

Convenience method to do (mostly) this:

   Pod::LOL->new->parse_file( $file )->{root};

_handle_element_start

Overrides Pod::Simple. Executed when a new pod element starts such as:

   "head1"
   "Para"

_handle_text

Overrides Pod::Simple. Executed for each text element such as:

   "NAME"
   "Pod::LOL - parse Pod into a list of lists (LOL)"

_handle_element_end

Overrides Pod::Simple. Executed when a pod element ends. Such as when these tags end:

   "head1"
   "Para"

SEE ALSO

App::Pod

Pod::Query

Pod::Simple

AUTHOR

Tim Potapov, <tim.potapov[AT]gmail.com>

BUGS

Please report any bugs or feature requests to https://github.com/poti1/pod-lol/issues.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Pod::LOL

You can also look for information at:

https://metacpan.org/pod/Pod::LOL https://github.com/poti1/pod-lol

ACKNOWLEDGEMENTS

TBD

LICENSE AND COPYRIGHT

This software is Copyright (c) 2022 by Tim Potapov.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)