This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #90632] perlfunc: Rewrite `split'
authorMichael Witten <mfwitten@gmail.com>
Fri, 6 Jan 2012 21:11:37 +0000 (13:11 -0800)
committerFather Chrysostomos <sprout@cpan.org>
Fri, 6 Jan 2012 21:17:06 +0000 (13:17 -0800)
commitbd4675851936488a7b28a813c5b60248be3e733b
treed2b64ca31505ed6f61081a49b00fadbf61305139
parent1887da8c8b4c2918391dd3622f46d626881ba3e6
[perl #90632] perlfunc: Rewrite `split'

I couldn't stand the way the documenation for `split' was written;
it felt like a kludge of broken English dumped into a messy pile by
several people, each of whom was unaware of the other's work.

This variation completes sentences, adds new ones, rearranges ideas,
expands on ideas, simplifies and unifies examples, and includes more
cross references.

While the original text seemed to be written in a way that touched upon
the arguments in reverse order (which did have a hint of elegance), this
version attempts to provide the reader with the most useful information
upfront.

Thanks to Brad Baxter and Thomas R. Sibley for their constructive
criticism.

[Modified by the committer to incorporate suggestions from Aristotle
Pagaltzis and Tom Christiansen.]
pod/perlfunc.pod