=head1 NAME

Pod::Index::example - this is a sample indexed file

=head1 SYNOPSIS
X<synopsis>

    blah blah blah

=head1 DESCRIPTION

This is the description. Let's describe some stuff.

This is a random paragraph.
X<random>

This is another paragraph, followed by a verbatim block or two:
X<verbatim>

    this is an example

    this is another example

=over

=item hydrogen
X<hydrogen>
X<protium>
X<deuterium>
X<tritium>

=item deuterium

=item tritium

These are the isotopes of element 1. Let's add some nested items:

=over

=item H20

water

=item D2O

heavy water

=back

=item helium
X<helium>
X<balloon, floating>
X<balloon, light>
X<balloon, gas-filled, helium>
X<random>

Helium is used for filling balloons.

=back

=head2 HEAD2
X<head2>
X<balloon>

This is to see if the head2 block is selected correctly.

    for example,

this paragraph should be included.

=head1 SEE ALSO
X<Tritium>
X<tritium, clocks>
X<Tritium, leaks>

Stuff

=cut