On Thu, Jul 1, 2010 at 16:40, Paul Johnson <p...@pjcj.net> wrote:
snip
>> * Updating the documentation so that all examples longer than one
>> line contain a `use` statement indicating the minimum version of
>> Perl 5 required to run the example
>
> I'm afraid that I don't think this is a sensible suggestion at all. I
> took a look at a few pages, almost at random. I looked at perldata,
> perlfaq3, perllol and perlcall. Adding C<use 5;>, as it would often be,
> a dozen or more times in a document adds little value but greatly
> detracts from the flow of the document.
>
> Is this really a problem. Are there many people out there trying to use
> qr// on 5.003, for example? I can see some value in noting that C<when>
> as a statement modifier is unavailable before 5.12, for example, but as
> a general policy I feel it is misguided. Please reconsider this idea.
snip
Failure to add a use 5.010; or use 5.012; limits the features that can
be used in examples. For instance, this example won't work even under
5.12 as it is written:
say "foo";
It is possible that we should only add use statements to examples that
need features in 5.10 or later.
--
Chas. Owens
wonkden.net
The most important skill a programmer can have is the ability to read.
