On Thu, March 7, 2013 10:24 pm, Linda W wrote:
> Is this a limitation or a unfixed bug?
>
> I noticed the html version on cpan of my module looked poopy... it was
> all broken funny and things that lined up on a terminal didn't (C<mea
> culpa>).
>
> But I also noticed non-breaking spaces ignored...?

I think you are confusing non-breaking spaces with preformatted text (eg.
<pre> in HTML). non-breaking means "don't word wrap", not "respect the
exact number of spaces I'm putting in".

what you are looking for are called Verbatim Paragraphs (cfr. perldoc
perlpod).

for example, this:

=over 4

S<my %complex_probs = (                                >
S<    questions =E<gt> [ "sqrt(-4)",  "(1-i)**2"     ],>
S<    answers   =E<gt> [ {real =E<gt> 0, i =E<gt>2 }, >
S<                   {real =E<gt> 0, i =E<gt> -2 } ] );>
S<P "my probs = %s", \%complex_probs;>

=back

is totally unnecessary (and ineffective). could be simply written as:

    my %complex_probs = (
        questions => [ "sqrt(-4)",  "(1-i)**2"     ],
        answers   => [ {real => 0, i =>2 },
                       {real => 0, i => -2 } ] );
    P "my probs = %s", \%complex_probs;

also: you seem to have SYNOPSIS and DESCRIPTION mixed up. please, look at
some other pod on CPAN and try to follow the conventions.

cheers,
Aldo


Reply via email to