File 3692-Add-detailed-instructions-for-updating-Uni... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 3692-Add-detailed-instructions-for-updating-Unicode-Chara.patch of Package erlang

From 6521e807f1c7e5434952f9bfedae9711b0eae739 Mon Sep 17 00:00:00 2001
From: Eksperimental <eksperimental@autistici.org>
Date: Mon, 10 Jan 2022 14:46:47 -0500
Subject: [PATCH] Add detailed instructions for updating Unicode Character
 Database

---
 lib/stdlib/uc_spec/README-UPDATE.txt | 52 +++++++++++++++++++++++-----
 1 file changed, 43 insertions(+), 9 deletions(-)

diff --git a/lib/stdlib/uc_spec/README-UPDATE.txt b/lib/stdlib/uc_spec/README-UPDATE.txt
index 07ebb4726a..d6b8488928 100644
--- a/lib/stdlib/uc_spec/README-UPDATE.txt
+++ b/lib/stdlib/uc_spec/README-UPDATE.txt
@@ -1,11 +1,45 @@
-When updating the unicode version copy the necessary files to this
-directory.
-And update the test files in stdlib/test/unicode_util_SUITE_data/*
-
 Unicode 14.0.0 was updated from:
-https://www.unicode.org/Public/14.0.0/ucd/
-https://www.unicode.org/Public/14.0.0/ucd/auxiliary/
-https://www.unicode.org/Public/14.0.0/ucd/emoji/
+- https://www.unicode.org/Public/13.0.0/ucd/
+- https://www.unicode.org/Public/13.0.0/ucd/auxiliary/
+- https://www.unicode.org/Public/13.0.0/ucd/emoji/
+
+When updating the Unicode version please follow these steps:
+
+The latest vesrion of the Unicode Character Database can be found at
+https://www.unicode.org/Public/UCD/latest/ucd/
+
+1. Copy the following files to lib/stdlib/uc_spec/ replacing existing ones.
+No subfolder should be created.
+  - CaseFolding.txt
+  - CompositionExclusions.txt
+  - PropList.txt
+  - SpecialCasing.txt
+  - UnicodeData.txt
+  - auxiliary/GraphemeBreakProperty.txt
+  - emoji/emoji-data.txt
+
+2. Copy the following test files to lib/stdlib/test/unicode_util_SUITE_data/
+replacing existing ones. No subfolder should be created.
+  - NormalizationTest.txt
+  - auxiliary/GraphemeBreakTest.txt
+  - auxiliary/LineBreakTest.txt
+
+3. Update the "spec_version()" function in the generator by replacing the Unicode
+version in lib/stdlib/uc_spec/gen_unicode_mod.escript
+
+4. Read the realease notes by visiting https://www.unicode.org/versions/latest/
+and assess if additional changes are necessary in the Erlang code.
+
+5. Replace all ocurrences of previous version of Unicode with the new one in
+this very same file (lib/stdlib/uc_spec/README-UPDATE.txt).
+Remember to update these instructions if a new file is added or any other change
+is required for future version updates.
 
-Update the spec_version(..) function in the generator,
-gen_unicode_mod.escript
+6. Run the test for the Unicode suite from the OTP repository root dir.
+   $ export ERL_TOP=$PWD
+   $ export PATH=$ERL_TOP/bin:$PATH
+   $ ./otp_build all -a && ./otp_build tests
+   $ cd release/tests/test_server
+   $ erl
+   erl> ts:install().
+   erl> ts:run(stdlib, unicode_SUITE, [batch]).
-- 
2.31.1

Places

File 3692-Add-detailed-instructions-for-updating-Unicode-Chara.patch of Package erlang

Places