develooper Front page | perl.perl5.porters | Postings from January 2012

[perl #90632] [PATCH] Docs: perlfunc: Rewrite `split'

From:
Father Chrysostomos via RT
Date:
January 6, 2012 13:21
Subject:
[perl #90632] [PATCH] Docs: perlfunc: Rewrite `split'
Message ID:
rt-3.6.HEAD-14510-1325884852-67.90632-15-0@perl.org
On Wed May 25 09:44:41 2011, mfwitten wrote:
> On Wed, May 25, 2011 at 16:30, Tom Christiansen <tchrist@perl.com> wrote:
> >>On Wed, May 25, 2011 at 16:03, Tom Christiansen <tchrist@perl.com>
wrote:
> >>>> Actually, I tried to use `delimiter' very strictly throughout
this text
> >>>> and this term is defined earlier as being the text in EXPR that
matches
> >>>> PATTERN:
> >>>>
> >>>>   Anything in EXPR that matches PATTERN is taken to be a delimiter
> >>>>   that separates the EXPR into substrings (called "I<fields>") that
> >>>>   do B<not> include the delimiter. Note that a delimiter may be
> >>>>   longer than one character or even have no characters at all (the
> >>>>   empty string, which is a zero-width match).
> >>>
> >>> But that's wrong.  A delimiter is a surrounder, not a separator.
> >>> Strings are quote-delimited.  Literal lists are comma-separated.
> >>> These are not at all like each other.
> >
> >> Perhaps so. I can buy that; I'll use `separator' then.
> >
> > Good. �Thanks. �Check perlglossary:
> 
> Awesome. Perhaps all of the documentation should link to the glossary
> more liberally?
> 
> >>> I feel much more strongly about this than I have here expressed,
> >>> and I hope I won't need to do so.
> >>
> >> What on earth do you mean? Are you holding back, good man?
> >
> > Why certainly, but it's better that way.
> >
> > But as you insist, here is a taste.
> >
> > [a taste]
> 
> Outstanding!
> 
> I, for one, appreciate your robust expostulation.
> 

I’ve taken your patch and incorporated suggestions from others as best I
can.  I also omitted the part about things that optimise to a single
space, because I consider that a bug.

I have applied the result as bd46758519.  Thank you.

-- 

Father Chrysostomos


---
via perlbug:  queue: perl5 status: open
https://rt.perl.org:443/rt3/Ticket/Display.html?id=90632



nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About