Subject: | Pod::Usage ignores subsections (e.g. =head2, -head3) w/ verbosity=1 |
If the "OPTIONS AND ARGUMENTS" section contains subsections, they are
not output. For example, running
pod2usage --verbose 1 test.pod
on the attached file results in
Options and Arguments:
rather than the expected result of printing everything. For complex
programs this is a real problem, as it is useful to group the options
into separate sections to provide context for the user.
Thanks,
Diab
Subject: | test.pod |
=head1 OPTIONS AND ARGUMENTS
=head2 Arguments
The required arguments (which typically follow any options on the
command line) are:
=over
=item I<destination>
=item I<files>
=back
=head2 Options
Options may be abbreviated. Options which take values may be separated
from the values by whitespace or the "=" character.