Mark Overmeer <[EMAIL PROTECTED]> writes:
> Oops, someone starts the holy war (again). Wether you put the docs
> in begin or end of the file, or intermixed with the code has a lot
> to do with your personal background.
Sorry for the late reply, but I can't let this stand without further
elaboration: intermixing the POD with the functions is something some
of us would really like to do, but in Perl5 the evil stupid whitespace
rules of POD make it impracticable, because it horks over the
indentation (and thus the legibility) of the whole program.
If we fix nothing else about POD in Perl6, it is *imperative* that it
become possible to indent the POD to at least the same level as the
code. Otherwise POD will never become a viable substitute for the
extensive comment blocks it ought to displace.
--
$;=sub{$/};@;=map{my($a,$b)=($_,$;);$;=sub{$a.$b->()}}
split//,"[EMAIL PROTECTED]/ --";$\=$ ;-> ();print$/
