From 582e5df9c78eee6ec235df57f8ab30c7e0bc7d12 Mon Sep 17 00:00:00 2001 From: Karl Williamson Date: Sun, 6 Nov 2011 16:03:50 -0700 Subject: [PATCH] perluniprops: Remove Unicode db files section Now that Unicode::UCD presents an API for accessing all the files, there is no need to document this less-favored method. --- lib/unicore/mktables | 106 --------------------------------------------------- 1 file changed, 106 deletions(-) diff --git a/lib/unicore/mktables b/lib/unicore/mktables index eab9ec3..ec893af 100644 --- a/lib/unicore/mktables +++ b/lib/unicore/mktables @@ -13691,62 +13691,6 @@ END $ucd_pod = format_pod_line($indent_info_column, 'NAME', ' INFO') . "\n" . $ucd_pod; - - # Generate a list of the properties whose map table we output, from the - # global @map_properties. - my @map_tables_actually_output; - my $info_indent = 20; # Left column is narrower than \p{} table. - foreach my $property (@map_properties) { - - # Get the path to the file; don't output any not in the standard - # directory. - my @path = $property->file_path; - next if $path[0] ne $map_directory; - - # Don't mention map tables that are for internal-use only - next if $property->to_output_map == $INTERNAL_MAP; - - shift @path; # Remove the standard name - - my $file = join '/', @path; # In case is in sub directory - my $info = $property->full_name; - my $short_name = $property->name; - if ($info ne $short_name) { - $info .= " ($short_name)"; - } - foreach my $more_info ($property->description, - $property->note, - $property->status_info) - { - next unless $more_info; - $info =~ s/\.\Z//; - $info .= ". $more_info"; - } - push @map_tables_actually_output, format_pod_line($info_indent, - $file, - $info, - $property->status); - } - - # Sort alphabetically, and fold for output - @map_tables_actually_output = sort - pod_alphanumeric_sort @map_tables_actually_output; - @map_tables_actually_output - = simple_fold(\@map_tables_actually_output, - ' ', - $info_indent, - $automatic_pod_indent); - - # Generate a list of the formats that can appear in the map tables. - my @map_table_formats; - foreach my $format (sort keys %map_table_formats) { - push @map_table_formats, - Text::Tabs::expand("$format\t$map_table_formats{$format}\n"); - } - @map_table_formats = simple_fold(\@map_table_formats, - ' ', - 8, - $automatic_pod_indent); local $" = ""; # Everything is ready to assemble. @@ -14072,56 +14016,6 @@ controlling lists contained in the program C<\$Config{privlib}>/F and then re-compiling and installing. (C<\%Config> is available from the Config module). -=head1 Files in the I directory (for serious hackers only) - -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. Some, but not all, of these are written out into files. -Those written out are in the directory C<\$Config{privlib}>/F -(C<%Config> is available from the C module). - -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.14. If those change, a deprecation cycle will be done first. These -are: - -@map_tables_actually_output - -Each of the files in this directory defines several hash entries to help -reading programs decipher it. One of them looks like this: - - \$utf8::SwashInfo{'ToNAME'}{'format'} = 's'; - -where "NAME" is a name to indicate the property. For backwards compatibility, -this is not necessarily the property's official Unicode name. (The "To" is -also for backwards compatibility.) The hash entry gives the format of the -mapping fields of the table, currently one of the following: - -@map_table_formats - -This format applies only to the entries in the main body of the table. -Entries defined in hashes or ones that are missing from the list can have a -different format. - -The value that the missing entries have is given by another SwashInfo hash -entry line; it looks like this: - - \$utf8::SwashInfo{'ToNAME'}{'missing'} = 'NaN'; - -This example line says that any Unicode code points not explicitly listed in -the file have the value "NaN" under the property indicated by NAME. If the -value is the special string C<< >>, it means that the value for -any missing code point is the code point itself. This happens, for example, -in the file for Uppercase_Mapping (To/Upper.pl), in which code points like the -character "A", are missing because the uppercase of "A" is itself. - -Finally, if the file contains a hash for special case entries, its name is -specified by an entry that looks like this: - - \$utf8::SwashInfo{'ToNAME'}{'specials_name'} = 'utf8::ToSpecNAME'; - - =head1 Other information in the Unicode data base The Unicode data base is delivered in two different formats. The XML version -- 2.7.4