cvsuser 04/01/31 14:59:20
Modified: docs strings.pod Log: Add ABSTRACT and OVERVIEW per Mitchell N Charity's patch in #23411. Revision Changes Path 1.15 +18 -0 parrot/docs/strings.pod Index: strings.pod =================================================================== RCS file: /cvs/public/parrot/docs/strings.pod,v retrieving revision 1.14 retrieving revision 1.15 diff -u -w -r1.14 -r1.15 --- strings.pod 5 Oct 2003 10:26:29 -0000 1.14 +++ strings.pod 31 Jan 2004 22:59:20 -0000 1.15 @@ -17,6 +17,24 @@ This document describes how Parrot abstracts the programmer's interface to string types. +=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. + =head1 The Parrot String API All strings used in the Parrot core should use the
