This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perluniprops: Update info about unicore/To files
authorKarl Williamson <public@khwilliamson.com>
Sat, 26 Mar 2011 23:53:53 +0000 (17:53 -0600)
committerKarl Williamson <public@khwilliamson.com>
Sun, 27 Mar 2011 00:01:34 +0000 (18:01 -0600)
5.14 now writes out most Unicode mapping files into the To subdirectory,
but we don't want people to use them and force us to be bound by their
formats and existence.  I plan to add a new routine in 5.16 in
Unicode::UCD that gives access to their contents.

lib/unicore/mktables

index d097cdb..2d1deb3 100644 (file)
@@ -13264,35 +13264,19 @@ C<\$Config{privlib}>/F<unicore/mktables> and then re-compiling and installing.
 All Unicode properties are really mappings (in the mathematical sense) from
 code points to their respective values.  As part of its build process,
 Perl constructs tables containing these mappings for all properties that it
-deals with.  But only a few of these are written out into files.
+deals with.  Some, but not all, of these are written out into files.
 Those written out are in the directory C<\$Config{privlib}>/F<unicore/To/>
 (%Config is available from the Config module).
 
-Those ones written are ones needed by Perl internally during execution, or for
-which there is some demand, and those for which there is no access through the
-Perl core.  Generally, properties that can be used in regular expression
-matching do not have their map tables written, like Script.  Nor are the
-simplistic properties that have a better, more complete version, such as
-Simple_Uppercase_Mapping  (Uppercase_Mapping is written instead).
-
-None of the properties in the I<To> directory are currently directly
-accessible through the Perl core, although some may be accessed indirectly.
-For example, the uc() function implements the Uppercase_Mapping property and
-uses the F<Upper.pl> file found in this directory.
-
-The available files in the current installation, with their properties (short
-names in parentheses), and any flags or comments about them, are:
+Perl reserves the right to change the format and even the existence of any of
+those files without notice, except the ones that were in existence prior to
+release 5.13.  If those change, a deprecation cycle will be done first.  These
+are:
 
 @map_tables_actually_output
 
-An installation can choose to change which files are generated by changing the
-controlling lists contained in the program
-C<\$Config{privlib}>/F<unicore/mktables> and then re-running F<mktables>
-(but the Unicode database must have been downloaded from
-L<http://www.unicode.org/Public/> to C<\$Config{privlib}>F</unicore/> first).
-
-Each of these files defines two hash entries to help reading programs decipher
-it.  One of them looks like this:
+Each of the files in this directory defines two hash entries to help reading
+programs decipher it.  One of them looks like this:
 
     \$utf8::SwashInfo{'ToNAME'}{'format'} = 's';