# New Ticket Created by  mcharity@[...].org 
# Please include the string:  [perl #23411]
# in the subject line of all future correspondence about this issue. 
# <URL: http://rt.perl.org/rt2/Ticket/Display.html?id=23411 > 



This patch creates ABSTRACT and OVERVIEW sections in docs/strings.pod.
The text is a zero-effort placeholder draft.
Its purpose is to capture the intent of Parrot Strings, which has
recently been a topic of discussion on the mailinglist.
It may or may not reflect the current code.
Shamelessly plagiarized from Larry, via Tim.

Specifically:

  =head1 ABSTRACT

  Parrot Strings are chunked international strings.

  =head1 OVERVIEW

  For various reasons, some of which relate to the sequence-of-integer
  abstraction, and some of which relate to "infinite" strings and arrays,
  Parrot Strings are represented by a list of chunks, where each chunk
  is a sequence of integers of the same size or representation,
  but different chunks can have different integer sizes or representations.
  The Parrot String API hides this from any module that wishes to work
  at the abstract string level.  In particular, it must hide this from
  the regex engine, which works on pure sequences in the abstract.

  So Parrot Strings are a wizzy internationalized equivalent of the
  old standard C library's string.h functions.



-- attachment  1 ------------------------------------------------------
url: http://rt.perl.org/rt2/attach/63067/46437/ba7520/string_pod_abstract.patch