• foo

  • bar

  • baz

list_is empty_list => <<'END_POD'; =begin :list

list_is tight_bullet => <<'END_POD'; =begin :list

* foo * bar * baz

  • foo

  • bar

  • baz

list_is loose_bullet => <<'END_POD'; =begin :list

* foo

* bar

* baz

  • foo

  • bar

  • baz

list_is bullets_with_wrapping => <<'END_POD'; =begin :list

* foo continues

* bar continues But this is new * baz

  • foo continues

  • bar continues

    But this is new

  • baz

list_is tight_num => <<'END_POD'; =for :list 1. foo 2. bar 3. baz ------------------------------------ =over 4

  1. foo

  2. bar

  3. baz

list_is tight_num_repeated => <<'END_POD'; =for :list 1. foo 1. bar 1. baz ------------------------------------ =over 4

  1. foo

  2. bar

  3. baz

# It's important to realize that in this example, 1. foo makes the =item # and then a standalone "foo" paragraph. The rest of the content until the # next bullet becomes a single paragraph.

list_is num_with_paras => <<'END_POD'; =for :list 1. foo Foo is an important aspect of Foo::Bar. It really is. It's hard to explain just how important. 2. bar 3. baz Baz is also important, but compared to Foo, Baz isn't even Bar. ------------------------------------ =over 4

  1. foo

    Foo is an important aspect of Foo::Bar. It really is. It's hard to explain just how important.

  2. bar

  3. baz

    Baz is also important, but compared to Foo, Baz isn't even Bar.

list_is num_with_wrapping_and_paras => <<'END_POD'; =for :list 1. foo continues Foo is an important aspect of Foo::Bar. It really is. It's hard to explain just how important. 2. bar 3. baz Baz is also important, but compared to Foo, Baz isn't even Bar. ------------------------------------ =over 4

  1. foo continues

    Foo is an important aspect of Foo::Bar. It really is. It's hard to explain just how important.

  2. bar

  3. baz

    Baz is also important, but compared to Foo, Baz isn't even Bar.

list_is def_with_custom_indent => <<'END_POD'; =begin :list :over<6>

= TLA Three-letter acronym.

= TBD To be defined.

= ETC And so on and so forth.

TLA

Three-letter acronym.

TBD

To be defined.

ETC

And so on and so forth.

list_is nested_complex => <<'END_POD'; =begin :list

1. foo

Foo is an important aspect of foo.

2. bar

Bar is also important, and takes options:

3. baz

Reasons why Baz is important:

  1. foo

    Foo is an important aspect of foo.

  2. bar

    Bar is also important, and takes options:

    height

    It's supplied in in pixels.

    width

    It's supplied in inches.

    And those are all of them.

  3. baz

    Reasons why Baz is important:

    bananas

    Yellow with a peel.

    Banderas

    Fellow with appeal.

list_is nested_complex_with_custom_indent => <<'END_POD'; =begin :list :over<3>

1. foo

Foo is an important aspect of foo.

2. bar

Bar is also important, and takes options:

3. baz

Reasons why Baz is important:

  1. foo

    Foo is an important aspect of foo.

  2. bar

    Bar is also important, and takes options:

    height

    It's supplied in in pixels.

    width

    It's supplied in inches.

    And those are all of them.

  3. baz

    Reasons why Baz is important:

    bananas

    Yellow with a peel.

    Banderas

    Fellow with appeal.

30 POD Errors

The following errors were encountered while parsing the POD:

Around line 42:

'=item' outside of any '=over'

Around line 54:

=back doesn't take any parameters, but you said =back END_POD

Around line 60:

'=end :list -------------------------------------- =over 4' is invalid. (Stack: [empty])

Around line 64:

=back doesn't take any parameters, but you said =back END_POD

=back without =over

Around line 74:

'=end :list ------------------------------------ =over 4' is invalid. (Stack: [empty])

Around line 78:

'=item' outside of any '=over'

Around line 90:

=back doesn't take any parameters, but you said =back END_POD

Around line 102:

'=end :list ------------------------------------ =over 4' is invalid. (Stack: [empty])

Around line 106:

'=item' outside of any '=over'

Around line 118:

=back doesn't take any parameters, but you said =back END_POD

Around line 132:

'=end :list ------------------------------------ =over 4' is invalid. (Stack: [empty])

Around line 136:

'=item' outside of any '=over'

Around line 150:

=back doesn't take any parameters, but you said =back END_POD

Around line 161:

'=item' outside of any '=over'

Around line 173:

=back doesn't take any parameters, but you said =back END_POD

Around line 184:

'=item' outside of any '=over'

Around line 196:

=back doesn't take any parameters, but you said =back END_POD

Around line 214:

'=item' outside of any '=over'

Around line 231:

=back doesn't take any parameters, but you said =back END_POD

Around line 246:

'=item' outside of any '=over'

Around line 263:

=back doesn't take any parameters, but you said =back END_POD

Around line 278:

'=end :list ------------------------------------ =over 6' is invalid. (Stack: [empty])

Around line 282:

'=item' outside of any '=over'

Around line 294:

=back doesn't take any parameters, but you said =back END_POD

Around line 337:

'=end :list ------------------------------------ =over 4' is invalid. (Stack: [empty])

Around line 341:

'=item' outside of any '=over'

Around line 401:

=back doesn't take any parameters, but you said =back END_POD

Around line 444:

'=end :list ------------------------------------ =over 3' is invalid. (Stack: [empty])

Around line 448:

'=item' outside of any '=over'

Around line 508:

=back doesn't take any parameters, but you said =back END_POD