PPI::Token::Pod(3) User Contributed Perl Documentation PPI::Token::Pod(3)

# [NAME](#NAME)

PPI::Token::Pod - Sections of POD in Perl documents

# [INHERITANCE](#INHERITANCE)

```
  PPI::Token::Pod
  isa PPI::Token
      isa PPI::Element
```

# [DESCRIPTION](#DESCRIPTION)

A single "PPI::Token::Pod" object represents a complete section of POD documentation within a Perl document.

# [METHODS](#METHODS)

This class provides some additional methods beyond those provided by its PPI::Token and PPI::Element parent classes.

## [merge @podtokens](#merge_@podtokens)

The "merge" constructor takes a number of "PPI::Token::Pod" objects, and returns a new object that represents one combined POD block with the content of all of them.

Returns a new "PPI::Token::Pod" object, or "undef" on error.

## [lines](#lines)

The "lines" method takes the string of POD and breaks it into lines, returning them as a list.

# [SUPPORT](#SUPPORT)

See the support section in the main module.

# [AUTHOR](#AUTHOR)

Adam Kennedy <adamk@cpan.org>

# [COPYRIGHT](#COPYRIGHT)

Copyright 2001 - 2011 Adam Kennedy.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

2026-10-25 perl v5.44.0

---

Document: PPI::Token::Pod(3pm) from perl-ppi 1.291-r2 (Chainguard OS)
Source: https://github.com/Perl-Critic/PPI