summaryrefslogtreecommitdiff
path: root/contrib/update-unicode/README
diff options
context:
space:
mode:
authorLibravatar Beat Bolli <dev+git@drbeat.li>2016-12-14 00:31:39 +0100
committerLibravatar Junio C Hamano <gitster@pobox.com>2016-12-13 16:12:47 -0800
commitf3eb54920eff356a30df144d50b45a5581e5eb13 (patch)
tree34be6ffc87b5ec37419a587fe00c0a613da39b08 /contrib/update-unicode/README
parentupdate_unicode.sh: delete the command group (diff)
downloadtgif-f3eb54920eff356a30df144d50b45a5581e5eb13.tar.xz
update_unicode.sh: move it into contrib/update-unicode
As it's used only by a tiny minority of the Git developer population, this script does not belong into the main Git source directory. Move it into contrib/ and adjust the paths to account for the new location. Signed-off-by: Beat Bolli <dev+git@drbeat.li> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'contrib/update-unicode/README')
-rw-r--r--contrib/update-unicode/README20
1 files changed, 20 insertions, 0 deletions
diff --git a/contrib/update-unicode/README b/contrib/update-unicode/README
new file mode 100644
index 0000000000..b9e2fc8540
--- /dev/null
+++ b/contrib/update-unicode/README
@@ -0,0 +1,20 @@
+TL;DR: Run update_unicode.sh after the publication of a new Unicode
+standard and commit the resulting unicode_widths.h file.
+
+The long version
+================
+
+The Git source code ships the file unicode_widths.h which contains
+tables of zero and double width Unicode code points, respectively.
+These tables are generated using update_unicode.sh in this directory.
+update_unicode.sh itself uses a third-party tool, uniset, to query two
+Unicode data files for the interesting code points.
+
+On first run, update_unicode.sh clones uniset from Github and builds it.
+This requires a current-ish version of autoconf (2.69 works per December
+2016).
+
+On each run, update_unicode.sh checks whether more recent Unicode data
+files are available from the Unicode consortium, and rebuilds the header
+unicode_widths.h with the new data. The new header can then be
+committed.