Bug#641430: libgetopt-euclid-perl: 0.2.9 does not recognise options in a =head2 inside =head1 OPTIONS

[Simon McVittie]

Package: libgetopt-euclid-perl
Version: 0.2.9-1
Severity: grave
Justification: unpredictable effects on previously-working software

mpd-dynamic, a script provided by libaudio-mpd-perl, uses Getopt::Euclid for
command-line options. G::E 0.2.7 recognises that it has command-line options,
but G::E 0.2.9 does not. An easy test case (which does not require you to
have mpd) is to run "mpd-dynamic --help" and see whether, for instance,
the "-sleep" option is listed.

In the case of mpd-dynamic, this is rather nasty, since it relies on
G::E to give it sensible defaults: for instance, it would normally sleep for
a few seconds between "main loop" iterations, but in the absence of a default
for $ARGV{sleep}, it busy-loops on an attempt to connect to an mpd server,
and the system quickly runs out of ports that are not in TIME_WAIT state.

The cause seems to be a couple of =head2 headings inside the OPTIONS =head1:

    =head1 OPTIONS

    =head2 General behaviour

    You can customize the usage of mpd-dynamic with the following options:

    =over 4

    =item -o[ld] <old>

Deleting the lines "=head2 General behaviour" and "=head2 Ratings" from
the mpd-dynamic script works around this. I think Getopt::Euclid should
really ignore those sub-headings, though.

Regards,
    S

-- System Information:
Debian Release: wheezy/sid
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'unstable'), (500, 'testing'), (500, 'stable'), (101, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 3.0.0-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages libgetopt-euclid-perl depends on:
ii  perl      5.12.4-4  
ii  perltidy  20101217-1

libgetopt-euclid-perl recommends no packages.

libgetopt-euclid-perl suggests no packages.

-- no debconf information