comment on

After fixing several syntax errors in your code, I get -special to work by adding a blank line after each =head1 line:

use warnings;
use strict;
use Pod::Usage;
use Getopt::Long;

GetOptions("help");

=head1 SYNOPSIS

         here's the main usage stuff

=head1 SPECIAL

        special usage stuff here...

=cut

# This prints SYNOPSIS above just fine as expected:
#pod2usage(-verbose => 0) if ($opt_help);  

# This only prints the '-message' and nothing else:
pod2usage({-verbose => 99,
           -sections => [qw(SPECIAL)],
           -message => "Here's special stuff...\n",
          });

__END__

Here's special stuff...

Special:
            special usage stuff here...
[download]

You should use podchecker on your code:

*** WARNING: empty section in previous paragraph at line ... in file .
+..
[download]

In reply to Re: pod::usage "-sections" not working by toolic
in thread pod::usage "-sections" not working by johnguillory

Are you posting in the right place? Check out Where do I post X? to know for sure.
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
Want more info? How to link or How to display code and escape characters are good places to start.


laziness, impatience, and hubris
	PerlMonks