summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/ucs/INSTALL.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-08-13 21:20:49 +0000
committerKarl Berry <karl@freefriends.org>2022-08-13 21:20:49 +0000
commit58e01b753b14b57964ffe034d014afd69ec340e0 (patch)
tree9d81c1227a6bd195b307cf5c89cd65d0a383233a /Master/texmf-dist/doc/latex/ucs/INSTALL.txt
parent212a3bb38611558d015360417e6cf25c8416e26c (diff)
ucs (13aug22)
git-svn-id: svn://tug.org/texlive/trunk@64114 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/ucs/INSTALL.txt')
-rw-r--r--Master/texmf-dist/doc/latex/ucs/INSTALL.txt53
1 files changed, 53 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/ucs/INSTALL.txt b/Master/texmf-dist/doc/latex/ucs/INSTALL.txt
new file mode 100644
index 00000000000..d9e4571f416
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ucs/INSTALL.txt
@@ -0,0 +1,53 @@
+1. INSTALLATION
+
+To install, simply put the files ucs.sty, utf8x.def, ucsencs.def and
+data/* somewhere in your TeX-path. If you want CJK characters, you need
+the c??enc.def files, too. For Klingon you need lklenc.def and
+lklkli.fd.
+
+You may have to run some command like mktexlsr, lest the files will not
+be found by TeX. What to do, however, is distribution dependent.
+
+Warning: If you install the files into some directory, where TeX does
+not search recursively (usually the current directory and your personal
+TeX directory are of that kind), you have to put the contents of data
+directly into that directory.
+
+If you don't install data/uninames.dat, you will save about 300 KB, but
+you won't get the full names of the characters in error messages.
+
+If you have added glyphs macros in one of the files in config (see
+perldoc makeunidef.pl for information on the config file format), you
+have to recreate the files in data by running "make datafiles". This
+uses makeunidef.pl internally.
+
+You can also run the makeunidef.pl directly. When doing this, you may
+supply another target directory instead of data, e.g. some directory in
+your TeX-path. makeunidef.pl will not delete or overwrite any files it
+has not created itself. If you add "--exclude
+cjkbg5,cjkgb,cjkjis,cjkhangul", CJK characters will not be included,
+saving more than 1 MB of disk space.
+
+2. GETTING THE SOURCE CODE REPOSITORY
+
+Install darcs from <http://darcs.net/>, if you do not have done this
+yet. Then check out the ucs repository with the following command:
+
+ darcs get http://darcs.wolfgang.jeltsch.info/tex/ucs
+
+3. BUILDING
+
+If you are working with the source code repository, you will probably
+want to build the autogenerated files at some point. To do this, run
+(GNU) make in the root directory of the repository.
+
+4. CREATING A DISTRIBUTION BUNDLE
+
+Running
+
+ make dist
+
+in the root directory of the repository gives you a file ucs.tar.gz.
+This file contains all source files and all autogenerated files, and has
+the "executable" bit set for all scripts. It is intended for uploading
+to CTAN.