[Emacs-diffs] emacs-24 r117291: admin/notes/unicode: Some notes about what to do when a new Unicode version is imported.

[Eli Zaretskii]

------------------------------------------------------------
revno: 117291
revision-id: address@hidden
parent: address@hidden
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-24
timestamp: Tue 2014-06-24 19:58:06 +0300
message:
  admin/notes/unicode: Some notes about what to do when a new Unicode version 
is imported.
modified:
  admin/ChangeLog                changelog-20091113204419-o5vbwnq5f7feedwu-2226
  admin/notes/unicode            unicode-20091113204419-o5vbwnq5f7feedwu-8579

=== modified file 'admin/ChangeLog'
--- a/admin/ChangeLog   2014-06-24 07:07:03 +0000
+++ b/admin/ChangeLog   2014-06-24 16:58:06 +0000
@@ -1,3 +1,8 @@
+2014-06-24  Eli Zaretskii  <address@hidden>
+
+       * notes/unicode: Some notes about what to do when a new Unicode
+       version is imported.
+
 2014-06-24  Glenn Morris  <address@hidden>
 
        * unidata/BidiMirroring.txt: Update to 7.0.0 (only comment changes).

=== modified file 'admin/notes/unicode'
--- a/admin/notes/unicode       2014-01-01 07:43:34 +0000
+++ b/admin/notes/unicode       2014-06-24 16:58:06 +0000
@@ -3,6 +3,39 @@
 Copyright (C) 2002-2014 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
+Importing a new Unicode Standard version into Emacs
+-------------------------------------------------------------
+
+Emacs uses the following files from the Unicode Character Database
+(a.k.a. "UCD):
+
+  . UnicodeData.txt
+  . BidiMirroring.txt
+  . IVD_Sequences.txt
+
+First, these files need to be copied into admin/unidata/, and then
+Emacs should be rebuilt for them to take effect.  Rebuilding Emacs
+updates several derived files elsewhere in the Emacs source tree,
+mainly in lisp/international/.
+
+When Emacs is rebuilt for the first time after importing the new
+files, pay attention to any warning or error messages.  In particular,
+admin/unidata/unidata-gen.el will complain if UnicodeData.txt defines
+new bidirectional attributes of characters, because unidata-gen.el,
+bidi.c and dispextern.h need to be updated in that case; failure to do
+so will cause aborts in redisplay.
+
+Next, review the changes in UnicodeData.txt vs the previous version
+used by Emacs.  Any changes, be it introduction of new scripts or
+addition of codepoints to existing scripts, need corresponding changes
+in the data used for filling char-script-table, see characters.el
+around line 1300.  Other databases and settings in characters.el, such
+as the data for char-width-table, might also need changes.
+
+Any new scripts added by UnicodeData.txt will also need updates to
+script-representative-chars defined in fontset.el.  Other databases in
+fontset.el might also need to be updated as needed.
+
 Problems, fixmes and other unicode-related issues
 -------------------------------------------------------------