in reply to Re: Worst thing you ever made with Perl
in thread Worst thing you ever made with Perl

=item C<authbox>
  authbox ($input, $callback);

   more stuff
=cut

[download]

No. You need extra blank lines in order to form command *paragraphs*. And you shouldn't indent normal text paragraphs, because it gets rendered as code then. And consider merging the first two lines: 

=item C<authbox \%input, \&callback>;

[download]

Juerd # { site => 'juerd.nl', plp_site => 'plp.juerd.nl', do_not_use => 'spamtrap' }

Replies are listed 'Best First'.
Re: Worst thing you ever made with Perl
by jonadab (Parson) on Sep 30, 2003 at 19:37 UTC

    Ewwww. Significant whitespace? You're kidding, right? I thought I dodged that bullet when I quit trying to learn Python and stuck with Perl. 

    $;=sub{$/};@;=map{my($a,$b)=($_,$;);$;=sub{$a.$b->()}}
split//,".rekcah lreP rehtona tsuJ";$\=$ ;->();print$/

    [download]
[reply]
[d/l]

      Significant whitespace?

      Yes.

      You're kidding, right?

      No.

      I thought I dodged that bullet when I quit trying to learn Python and stuck with Perl. 

      print 3 . 5;  # 35
print 3.5;    # 3.5

%foo = (bar => "xyzzy")
print "-$foo{bar}-";   # -xyzzy-
print "-$foo {bar}-";  # - {bar}-

$a = 1;
print $a - -5;  # 6
print $a -- 5;  # error

print q qhelloq;  # hello
print qqhelloq;   # qqhelloq

      [download]
      Etcetera, etcetera. Get used to it. Yes, POD has significant vertical whitespace.

      Juerd # { site => 'juerd.nl', plp_site => 'plp.juerd.nl', do_not_use => 'spamtrap' }

[reply]
[d/l]
        print 3 . 5;  # 35
print 3.5;    # 3.5

        [download]

        Warnings will catch that for you.

        %foo = (bar => "xyzzy")
print "-$foo{bar}-";   # -xyzzy-
print "-$foo {bar}-";  # - {bar}-

        [download]

        Putting a space in the middle of a variable is just a wee bit different from indenting lines within a function.

        $a = 1;
print $a - -5;  # 6
print $a -- 5;  # error

print q qhelloq;  # hello
print qqhelloq;   # qqhelloq

        [download]

        All of these examples are highly contrived, and not at all the same as wanting to indent lines to properly reflect a nested structure and being told that no, those lines should not be indented, because the leading whitespace is significant. And as for having blank lines be significant... the English language lacks the words to describe my view of that. At this point I'm thinking I'll probably continue to use comments as I have been doing, after all. The prospect of being able to automatically generate documentation from the POD comments embedded in the code was attractive to me in principle, but apparently it's not flexible enough to be used at all the way I want. 

        $;=sub{$/};@;=map{my($a,$b)=($_,$;);$;=sub{$a.$b->()}}
split//,".rekcah lreP rehtona tsuJ";$\=$ ;->();print$/

        [download]
[reply]
[d/l]
[select]

In Section Meditations