upmendex v0.52, documents from CTAN

git-svn-id: svn://tug.org/texlive/trunk@50480 c570f23f-e606-0410-a88d-b1316a301751

37 files changed, 1717 insertions, 17 deletions

diff --git a/Master/texmf-dist/doc/man/man1/Makefile b/Master/texmf-dist/doc/man/man1/Makefile
index a2c2d653c6e..753daa92f18 100644
--- a/Master/texmf-dist/doc/man/man1/Makefile
+++ b/Master/texmf-dist/doc/man/man1/Makefile
@@ -21,10 +21,12 @@ clean:
 %.man1.pdf: %.1
 	$(MKPDF)
 
-# Special case for mendex.1, which contains multi-byte characters.
+# Special case for mendex.1 and upmendex.1, which contains multi-byte characters.
 # leave it for Japanese maintainers
 man1/mendex.man1.pdf: man1/mendex.1
 	@echo 'Skipping mendex.1, leaving it to texjp.'
+man1/upmendex.man1.pdf: man1/upmendex.1
+	@echo 'Skipping upmendex.1.'
 
 # man pages which use UTF-8; probably there are more.
 man1/findhyph.man1.pdf: man1/findhyph.1
@@ -34,7 +36,7 @@ man1/luaotfload-tool.man1.pdf: man1/luaotfload-tool.1
 
 # 
 # See ../Makefile for the so.rules target which generates this list of rules.
-	
+
 man1/cslatex.man1.pdf: man1/cslatex.1 man1/latex.1
 	$(MKPDF)
 
diff --git a/Master/texmf-dist/doc/man/man1/upmendex.1 b/Master/texmf-dist/doc/man/man1/upmendex.1
new file mode 100644
index 00000000000..514fda7d4a4
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/upmendex.1
@@ -0,0 +1,642 @@
+.TH UPMENDEX 1
+\"=====================================================================
+.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
+.if n .ds TX TeX
+.\" LX definition must follow TX so LX can use TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if n .ds LX LaTeX
+\"=====================================================================
+.SH NAME
+upmendex \- Multilingual index processor
+.SH SYNOPSIS
+\fBupmendex\fR [-ilqrcgf] [\fB-s\fI sty\fR] [\fB-d\fI dic\fR] [\fB-o\fI ind\fR] [\fB-t\fI log\fR] [\fB-p\fI no\fR] [\fB--\fR] [\fI idx0 idx1 idx2 ...\fR]
+.br
+\fBupmendex\fR \fB--help\fR
+.SH DESCRIPTION
+.PP
+The program \fIupmendex\fR is a general purpose multilingual hierarchical
+index generator working with up\*(LX, Xe\*(LX and Lua\*(LX;
+it accepts one or more input files (\fI.idx\fR; often produced by a text
+formatter such as \*(LX families), sorts the entries, and produces an output file
+which can be formatted.
+It supports Latin (including non-English), Greek, Cyrillic, Korean Hangul and
+Han (Hanzi ideographs) scripts, as well as Japanese Kana.
+It is almost compatible with \fImakeindex\fR and \fImendex\fR, and
+additional feature for handling readings of kanji words is also available.
+.RE
+The formats of the input and output files are specified in a style file.
+The readings of kanji words can be specified in a dictionary file.
+.RE
+The index can have up to three levels (0, 1, and 2) of subitem nesting.
+.SH OPTIONS
+.PP
+.TP 10
+\fB-i\fR
+Take input from stdin, even when index files are specified.
+.TP 10
+\fB-l\fR
+Set \'sort by character order\'. By default, \'sort by word order\' is used.
+Details are described below.
+.TP 10
+\fB-q\fR
+Quiet mode; send no message to \fIstderr\fR, except error
+messages and warnings.
+.TP 10
+\fB-r\fR
+Disable implicit page range formation. By default, three or
+more successive pages are automatically abbreviated as a range
+(e.g. 1\(en5).
+.TP 10
+\fB-c\fR
+Compress sequence of intermediate blanks (space(s) and/or tab(s)) into a space
+and ignore leading and trailing blank(s).
+By default, blanks in the index key are retained.
+.TP 10
+\fB-g\fR
+Make Japanese index head \fIA\fR-line (\fIA, Ka, Sa, ...\fR) of the gojuon table (Japanese
+syllabary). By default, all the characters in the gojuon table
+are used.
+.TP 10
+\fB-f\fR
+Force to output characters even if the scripts are not supported by \fIupmendex\fR.
+.TP 10
+\fB-s\fI sty\fR
+Employ \fIsty\fR as the style file.
+.TP 10
+\fB-d\fI dic\fR
+Employ \fIdic\fR as the dictionary file. The dictionary file is
+composed of lists of <\fIindex_word\fR\ \fIreading\fR>.
+.TP 10
+\fB-o\fI ind\fR
+Employ \fIind\fR as the output index file. By default, the file
+name is created by appending the extension \fIind\fR to the base
+name of the first input file.
+.TP 10
+\fB-t\fI log\fR
+Employ \fIlog\fR as the transcript file. By default, the file name
+is created by appending the extension \fIilg\fR to the base name
+of the first input file.
+.TP 10
+\fB-p\fI no\fR
+Set the starting page number of the output index list to be
+\fIno\fR. The argument \fIno\fR may be numerical or one of
+the following: \fIany\fR (the next page to the end of contents), \fIodd\fR
+(the next odd page to the end of contents), \fIeven\fR (the next even page to the end of contents).
+.TP 10
+\fB--help\fR
+Show summary of options.
+.TP 10
+\fB--\fR
+Arguments after \fB--\fR are not taken as options.
+
+.SH "STYLE FILE"
+The style file informs \fIupmendex\fR about the format of the
+\fIidx\fR input files and the intended format of the final
+output file. The format is upper compatible with the one for
+\fImakeindex\fR and \fImendex\fR.
+The style file contains a list of
+<\fIspecifier\fR\ \fIattribute\fR> pairs.
+There are two types of specifiers: input and output.
+Pairs do not have to appear in any particular order.
+A line begun by \'%\' is a comment.
+
+.PP
+\fBInput file style parameter\fR
+.TP 30
+\fBkeyword\fR  <string>
+"\\\\indexentry"
+.RS
+Command with an argument of index entry.
+.RE
+.TP 30
+\fBarg_open\fR  <char>
+\'{\'
+.RS
+Opening delimiter which shows the beginning of index entry.
+.RE
+.TP 30
+\fBarg_close\fR  <char>
+\'}\'
+.RS
+Closing delimiter which shows the end of index entry.
+.RE
+.TP 30
+\fBrange_open\fR  <char>
+\'(\'
+.RS
+Opening delimiter which shows the beginning of page range.
+.RE
+.TP 30
+\fBrange_close\fR  <char>
+\')\'
+.RS
+Closing delimiter which shows the end of page range.
+.RE
+.TP 30
+\fBlevel\fR  <char>
+\'!\'
+.RS
+Delimiter which shows lower level.
+.RE
+.TP 30
+\fBactual\fR  <char>
+\'@\'
+.RS
+Symbol which shows the next sequence is to appear as index strings
+in the output file.
+.RE
+.TP 30
+\fBencap\fR  <char>
+\'|\'
+.RS
+Symbol which shows the next sequence is to be used as command name
+attached to the page number.
+.RE
+.TP 30
+\fBpage_compositor\fR  <string>
+"-"
+.RS
+Separator between page levels for a style with multi-levels of page numbers.
+.RE
+.TP 30
+\fBpage_precedence\fR  <string>
+"rnaRA"
+.RS
+Priority of expression for page number.
+\'R\' and \'r\' correspond to Roman. \'n\' corresponds to arabic numeral.
+\'A\' and \'a\' correspond to Latin alphabet.
+.RE
+.TP 30
+\fBquote\fR  <char>
+\'"\'
+.RS
+Escape character for \fIupmendex\fR parameters.
+.RE
+.TP 30
+\fBescape\fR  <char>
+\'\\\\\'
+.RS
+Escape character for general scripts.
+.RE
+
+\fBOutput file style parameter\fR
+.TP 30
+\fBpreamble\fR  <string>
+"\\\\begin{theindex}\\n"
+.RS
+Preamble of output file.
+.RE
+.TP 30
+\fBpostamble\fR  <string>
+"\\n\\n\\\\end{theindex}\\n"
+.RS
+Postamble of output file.
+.RE
+.TP 30
+\fBsetpage_prefix\fR  <string>
+"\\n  \\\\setcounter{page}{"
+.RS
+Prefix of page number if start page is designated.
+.RE
+.TP 30
+\fBsetpage_suffix\fR  <string>
+"}\\n"
+.RS
+Suffix of page number if start page is designated.
+.RE
+.TP 30
+\fBgroup_skip\fR  <string>
+"\\n\\n  \\\\indexspace\\n"
+.RS
+Strings to insert vertical space before new section of index.
+.RE
+.TP 30
+\fBlethead_prefix\fR  <string>
+""
+.RS
+Prefix of heading for newly appeared heading letter.
+.RE
+.TP 30
+\fBheading_prefix\fR  <string>
+""
+.RS
+Same as \fBlethead_prefix\fR.
+.RE
+.TP 30
+\fBlethead_suffix\fR  <string>
+""
+.RS
+Suffix of heading for newly appeared heading letter.
+.RE
+.TP 30
+\fBheading_suffix\fR  <string>
+""
+.RS
+Same as \fBlethead_suffix\fR.
+.RE
+.TP 30
+\fBlethead_flag\fR  <number>
+0
+.RS
+Flag to control output of heading letters.
+\'0\', \'1\', \'-1\' and \'2\' respectively denotes no output, uppercase,
+lowercase and titlecase.
+.RE
+.TP 30
+\fBheading_flag\fR  <number>
+0
+.RS
+Same as \fBlethead_flag\fR.
+.RE
+.TP 30
+\fBtumunja\fR  <string>
+"ㄱㄴㄷㄹㅁㅂㅅㅇㅈㅊㅋㅌㅍㅎ"
+.RS
+Heading characters of hangul specified by a string.
+(Extended by upmendex)
+.RE
+.TP 30
+\fBhanzi_head\fR  <string>
+""
+.RS
+Heading strings of hanzi (Kanji, Hanja)
+specified by a string, which is
+concatenated of items with a separator \';\'.
+(Extended by upmendex)
+.RE
+.TP 30
+\fBitem_0\fR  <string>
+"\\n  \\\\item "
+.RS
+Command sequence inserted between primary level entries.
+.RE
+.TP 30
+\fBitem_1\fR  <string>
+"\\n     \\\\subitem "
+.RS
+Command sequence inserted between sub level entries.
+.RE
+.TP 30
+\fBitem_2\fR  <string>
+"\\n       \\\\subsubitem "
+.RS
+Command sequence inserted between subsub level entries.
+.RE
+.TP 30
+\fBitem_01\fR  <string>
+"\\n    \\\\subitem "
+.RS
+Command sequence inserted between primaly and sub level entries.
+.RE
+.TP 30
+\fBitem_x1\fR  <string>
+"\\n    \\\\subitem "
+.RS
+Command sequence inserted between primary and sub level entries
+when main entry does not have page number.
+.RE
+.TP 30
+\fBitem_12\fR  <string>
+"\\n    \\\\subsubitem "
+.RS
+Command sequence inserted between sub and subsub level entries.
+.RE
+.TP 30
+\fBitem_x2\fR  <string>
+"\\n    \\\\subsubitem "
+.RS
+Command sequence inserted between sub and subsub level entries
+when sub level entry does not have page number.
+.RE
+.TP 30
+\fBdelim_0\fR  <string>
+", "
+.RS
+Delimiter string between primary level entry and first page number.
+.RE
+.TP 30
+\fBdelim_1\fR  <string>
+", "
+.RS
+Delimiter string between sub level entry and first page number.
+.RE
+.TP 30
+\fBdelim_2\fR  <string>
+", "
+.RS
+Delimiter string between subsub level entry and first page number.
+.RE
+.TP 30
+\fBdelim_n\fR  <string>
+", "
+.RS
+Delimiter string between page numbers
+commonly used for any entry level.
+.RE
+.TP 30
+\fBdelim_r\fR  <string>
+"--"
+.RS
+Delimiter string between pages to show page range.
+.RE
+.TP 30
+\fBdelim_t\fR  <string>
+""
+.RS
+Delimiter string output at the end of page number list.
+.RE
+.TP 30
+\fBsuffix_2p\fR  <string>
+""
+.RS
+String to be inserted in place of \fBdelim_n\fR and the next page
+number when the two pages are contiguous.
+.RE
+It works only when the parameter is defined.
+.RE
+.TP 30
+\fBsuffix_3p\fR  <string>
+""
+.RS
+String to be inserted in place of \fBdelim_r\fR and the third page
+number when the three pages are contiguous.
+The parameter is prior to \fBsuffix_mp\fR.
+.RE
+It works only when the parameter is defined.
+.RE
+.TP 30
+\fBsuffix_mp\fR  <string>
+""
+.RS
+String to be inserted in place of \fBdelim_r\fR and the last page
+number when the three or more pages are contiguous.
+.RE
+It works only when the parameter is defined.
+.RE
+.TP 30
+\fBencap_prefix\fR  <string>
+"\\\\"
+.RS
+Prefix for an encapsulating command
+when the encapsulating command is added to the page number.
+.RE
+.TP 30
+\fBencap_infix\fR  <string>
+"{"
+.RS
+Prefix just before the page number
+when the encapsulating command is added to the page number.
+.RE
+.TP 30
+\fBencap_suffix\fR  <string>
+"}".
+.RS
+Suffix after the page number
+when the encapsulating command is added to the page number.
+.RE
+.TP 30
+\fBline_max\fR  <number>
+72
+.RS
+Maximum number of one line.
+If exceed the number, lines are folded.
+.RE
+.TP 30
+\fBindent_space\fR  <string>
+"\t\t"
+.RS
+Space for indent which inserted to
+top of folded line.
+.RE
+.TP 30
+\fBindent_length\fR  <number>
+16
+.RS
+Length of space for indent which inserted to top of folded line.
+.RE
+.TP 30
+\fBsymhead_positive\fR  <string>
+"Symbols"
+.RS
+Strings to output as heading letter for numbers and symbols
+when lethead_flag or heading_flag is positive number.
+.RE
+.TP 30
+\fBsymhead_negative\fR  <string>
+"symbols"
+.RS
+Strings to output as heading letter for numbers and symbols
+when lethead_flag or heading_flag is negative number.
+.RE
+.TP 30
+\fBsymbol\fR  <string>
+""
+.RS
+Strings to output as heading letter for numbers and symbols
+when symbol_flag is non zero.
+.RE
+If specified, the option is prior to symhead_positive and symhead_negative.
+(Extended by (up)mendex)
+.RE
+.TP 30
+\fBsymbol_flag\fR  <number>
+1
+.RS
+Flag to output of symbol. If \'0\', do not output.
+(Extended by (up)mendex)
+.RE
+.TP 30
+\fBletter_head\fR  <number>
+1
+.RS
+Flag of heading letter for Japanese Kana.
+If \'1\' and \'2\', Katakana and Hiragana is used, respectively.
+(Extended by (up)mendex)
+.RE
+.TP 30
+\fBpriority\fR  <number>
+0
+.RS
+Flag of sorting method for index words composed of
+Japanese and non-Japanese (ex. Latin scripts).
+If non zero, one space (U+20) is inserted between
+Japanese sequence and non-Japanese sequence in sorting procedure.
+(Extended by (up)mendex)
+.RE
+.TP 30
+\fBcharacter_order\fR  <string>
+"SNLGCJKH"
+.RS
+Order of scripts and symbols.
+\'S\', \'N\', \'L\', \'G\', \'C\', \'J\', \'K\' and \'H\' respectively
+denotes symbol, number, Latin, Greek, Cyrillic, Japanese Kana, Korean Hangul and Hanja.
+(Extended by upmendex)
+.RE
+.TP 30
+\fBicu_locale\fR  <string>
+""
+.RS
+Locale in ICU collator.
+By default, "root sort order" is set.
+(Extended by upmendex)
+.RE
+.TP 30
+\fBicu_rules\fR  <string>
+""
+.RS
+Customized collation rules in ICU collator.
+Unicode characters in UTF-8 encoding and following escape sequences are accepted:
+\fB\\Uhhhhhhhh\fR (8-digit hexadecimal [0-9A-Fa-f]), \fB\\uhhhh\fR (4-digit hexadecimal),
+\fB\\xhh\fR (2-digit hexadecimal), \fB\\x{h...}\fR (1..8-digit hexadecimal), and
+\fB\\ooo\fR (3-digit octal [0-7]).
+By default, locale is used.
+(Extended by upmendex)
+.RE
+Ref. <http://userguide.icu-project.org/collation/customization>,
+<http://www.unicode.org/reports/tr35/tr35-collation.html#Rules>
+.RE
+.TP 30
+\fBicu_rules\fR  <string>
+""
+.RS
+Attributes in ICU collator.
+Followings are available:
+"alternate:shifted", "alternate:non-ignorable",
+"strength:primary", "strength:secondary", "strength:tertiary",
+"strength:quaternary", "strength:identical",
+"french-collation:on", "french-collation:off",
+"case-first:off", "case-first:upper-first", "case-first:lower-first",
+"case-level:on", "case-level:off",
+"normalization-mode:on", "normalization-mode:off"
+(Extended by upmendex)
+.RE
+Ref. <http://userguide.icu-project.org/collation/customization>,
+<http://www.unicode.org/reports/tr35/tr35-collation.html#Setting_Options>
+.RE
+.PP
+.SH ABOUT JAPANESE PROCESSING
+.PP
+\fIupmendex\fR has an additional feature to simplify the procedure of handling
+Japanese indexes, compared to \fImakeindex\fR. Users can save the effort
+of manually specifying a reading for every kanji word.
+.RE
+Japanese kanji words are usually sorted by the syllables of their readings
+(\fI\'Yomi\'\fR), which can be represented by kana (Hiragana, Katakana) scripts.
+\fIupmendex\fR accepts index words specified in kana expression directly on
+an input file, and also accepts conversion from index words to kana scripts
+by referring to Japanese dictionaries.
+.RE
+
+.LP
+Examples of internal simplification of syllables are shown below.
+.PP
+.RS
+.br
+かぶしきがいしゃ		かふしきかいしや
+.br
+マッキントッシュ		まつきんとつしゆ
+.br
+ワープロ			わあふろ
+.RE
+.LP
+The dictionary file consists of list with <\'index_word\' \'reading\'>.
+The index word can be written in any scripts (kanji, kana, etc),
+and the reading must be in Hiragana or Katakana scripts.
+The delimiter between the index word and its reading is one or more tab(s) or space(s).
+.RE
+An example of a Japanese dictionary is shown below.
+.PP
+.RS
+.br
+漢字		かんじ
+.br
+読み		よみ
+.br
+環境		かんきょう
+.br
+α		アルファ
+.RE
+.LP
+Here, each index word is allowed to have only one Yomi.
+Though some kanji words (ex. 「表」) may have more than one Yomi\'s
+(ex. 「ひょう」 and 「おもて」), only one of them can be registered in the dictionary.
+When some different Yomi\'s are needed, they should be specified explicitly
+in kana expression (ex. \\index{ひょう@表} or \\index{おもて@表}) on the input file.
+.RE
+Moreover, a dictionary file is automatically referred
+by setting the file name at an environment variable \fIINDEXDEFAULTDICTIONARY\fR.
+The dictionary set by the environment variable can be used
+together with file(s) specified by \fI-d\fR option.
+.PP
+.SH ABOUT SORTING PROCEDURE
+.PP
+\fIupmendex\fR sorts indexes as is (\'sort by word order\') by default.
+Setting \fI-l\fR option, spaces between words in an index are truncated prior to
+sorting procedure (\'sort by character order\').
+.RE
+Even when sort by character order, the index at output remains the original sequence
+without the truncation.
+.RE
+Follows show an example.
+.PP
+.RS
+\fIsort by word order		sort by character order\fR
+.br
+X Window			Xlib
+.br
+Xlib				XView
+.br
+XView				X Window
+.RE
+.LP
+In addition, two sorting methods can be applied for indexes
+which contains both Japanese kana and other scripts (e.g. Latin script).
+By setting \fIpriority\fR 0 (default) and 1 at a style file,
+a space between Japanese Kana and other scripts is inserted and
+not inserted respectively, prior to the sorting procedure.
+.RE
+Follows show an example.
+.PP
+.RS
+\fIpriority=0			priority=1\fR
+.br
+index sort			indファイル
+.br
+indファイル			index sort
+.RE
+.PP
+.SH ENVIRONMENT VARIABLES
+\fIupmendex\fR refers environment variables as follows.
+.PP
+.TP 10
+\fIINDEXSTYLE\fR
+Directory where index style files exist.
+.TP 10
+\fIINDEXDEFAULTSTYLE\fR
+Index style file to be referred to as default.
+.TP 10
+\fIINDEXDICTIONARY\fR
+Directory where dictionary files exist.
+.TP 10
+\fIINDEXDEFAULTDICTIONARY\fR
+Dictionary file which is automatically read.
+.PP
+.SH DETAIL
+Detailed specification is compatible with \fImakeindex\fR.
+.PP
+.SH KNOWN ISSUES
+When plural page number expression is used, \fI.idx\fR files should be
+specified along with the order of page numbers. Otherwise,
+wrong page numbers might be output.
+.PP
+.SH "SEE ALSO"
+.BR tex(1),
+.BR latex(1),
+.BR makeindex(1),
+.BR mendex(1).
+.br
+International Components for Unicode (ICU):
+<http://site.icu-project.org/>
+.SH AUTHOR
+This manual page was written by Takuji Tanaka
+based on the mendex manual page written by Japanese \*(TX Development Community.
diff --git a/Master/texmf-dist/doc/man/man1/upmendex.man1.pdf b/Master/texmf-dist/doc/man/man1/upmendex.man1.pdf
new file mode 100644
index 00000000000..d66b496be18
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/upmendex.man1.pdf
diff --git a/Master/texmf-dist/doc/upmendex/COPYRIGHT b/Master/texmf-dist/doc/upmendex/COPYRIGHT
new file mode 100644
index 00000000000..1cc83b01680
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/COPYRIGHT
@@ -0,0 +1,26 @@
+Copyright (C) 1995 ASCII Corporation, 2009 ASCII MEDIA WORKS,
+              2015-2019 TANAKA Takuji
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the author may be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/Master/texmf-dist/doc/upmendex/README.md b/Master/texmf-dist/doc/upmendex/README.md
index 3bedfef5737..4c55ed7a458 100644
--- a/Master/texmf-dist/doc/upmendex/README.md
+++ b/Master/texmf-dist/doc/upmendex/README.md
@@ -1,9 +1,10 @@
 upmendex  --- Multilingual index processor
 ==========================================
 
-2016.06.19 Ver0.51
+2019.02.17 Ver0.52
 
-TANAKA, Takuji   ttk(at)t-lab(dot)opal(dot)ne(dot)jp
+TANAKA, Takuji
+<ttk(at)t-lab.opal.ne.jp>
 
 
 ### About upmendex
@@ -13,12 +14,12 @@ upmendex is a multilingual index processor with following features:
    upper compatible with mendex,
    based on mendex version 2.6f by ASCII media works.
  * Unicode for internal process and
-   support UTF-8 encoding for input/outout.
+   support UTF-8 encoding for input/output.
    Will work with upLaTeX, XeLaTeX and luaLaTeX.
  * Support Latin (including non-English), Greek, Cyrillic,
    Korean Hangul and Han (Hanzi ideographs) scripts
    as well as Japanese Kana.
- * Apply International Components for Unicode (ICU)
+ * Apply International Components for Unicode (ICU)[4]
    for sorting process.
 
 ### Contents
@@ -27,19 +28,20 @@ upmendex is a multilingual index processor with following features:
  * doc/ :: documents
  * doc/samples/ :: samples for test.
    More samples are distributed at Ref. [2].
+ * man/ :: manuals
 
 ### Building upmendex
-The sources work with TeXLive svn r41496.
-Ref. [TeXLive and Subversion](http://www.tug.org/texlive/svn/)
+The source files are distributed at GitHub[2] and work with TeX Live svn r50040.
+Ref. [TeX Live and Subversion](http://www.tug.org/texlive/svn/)
 
-Tested with ICU 57.1 .
+Tested with ICU 63.1 .
 
 ### Status
 Beta version.
 No warranty.
 
 ### Copyright
-Lisence notice is written in COPYRIGHT .
+Lisence notice is written in [COPYRIGHT](./COPYRIGHT).
 It is as same as [the BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause)
 
 ### Supported locale
@@ -73,7 +75,8 @@ Follows are available for setting into "icu_locale".
 
 ### References
 1.  [ASCII Nihongo TeX (Publishing TeX)](http://ascii.asciimw.jp/pb/ptex/)
-    ASCII MEDIA WORKS
-2.  [upTeX, upLaTeX ― unicode version of pTeX, pLaTeX](http://www.t-lab.opal.ne.jp/tex/uptex_en.html)
-3.  [International Components for Unicode (ICU)](http://site.icu-project.org/)
+    ASCII MEDIA WORKS (dead link)
+2.  [Source/Document distribution of upmendex --- multilingual index processor @ GitHub](https://github.com/t-tk/upmendex-package)
+3.  [upTeX, upLaTeX ― unicode version of pTeX, pLaTeX](http://www.t-lab.opal.ne.jp/tex/uptex_en.html)
+4.  [International Components for Unicode (ICU)](http://site.icu-project.org/)
 
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/Makefile b/Master/texmf-dist/doc/upmendex/samples/alphabet/Makefile
new file mode 100644
index 00000000000..a33c0e11b85
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/Makefile
@@ -0,0 +1,37 @@
+UPMENDEX = upmendex
+
+alphabet: es zh
+
+es:
+	for num in 1 2 11 12 13 22 22 23; do \
+	for loc in es; do \
+		$(UPMENDEX) alpha_$$loc.idx -s mdxsty_$$loc$$num.ist -o alpha_$$loc$$num.ind ; \
+	done ; \
+	done
+
+zh:
+	for num in 1 2 11 12 13 14 21 22 31; do \
+	for loc in zh; do \
+		$(UPMENDEX) alpha_$$loc.idx -s mdxsty_$$loc$$num.ist -o alpha_$$loc$$num.ind ; \
+	done ; \
+	done
+	for num in 11 12 13 14; do \
+		loc='zh' ; \
+		locx='zhr' ; \
+		$(UPMENDEX) alpha_$$locx.idx -s mdxsty_$$loc$$num.ist -o alpha_$$locx$$num.ind ; \
+	done
+	for num in 21 22; do \
+		loc='zh' ; \
+		locx='zhs' ; \
+		$(UPMENDEX) alpha_$$locx.idx -s mdxsty_$$loc$$num.ist -o alpha_$$locx$$num.ind ; \
+	done
+	for num in 31; do \
+		loc='zh' ; \
+		locx='zhz' ; \
+		$(UPMENDEX) alpha_$$locx.idx -s mdxsty_$$loc$$num.ist -o alpha_$$locx$$num.ind ; \
+	done
+	for num in 1 2; do \
+		loc='zh' ; \
+		locx='zhp' ; \
+		$(UPMENDEX) alpha_$$locx.idx -s mdxsty_$$loc$$num.ist -o alpha_$$locx$$num.ind ; \
+	done
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_es.idx b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_es.idx
new file mode 100644
index 00000000000..7c3982df835
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_es.idx
@@ -0,0 +1,95 @@
+\indexentry{A}{101}
+\indexentry{B}{102}
+\indexentry{C}{103}
+\indexentry{CH}{160}
+\indexentry{D}{104}
+\indexentry{E}{105}
+\indexentry{F}{106}
+\indexentry{G}{107}
+\indexentry{H}{108}
+\indexentry{I}{109}
+\indexentry{J}{110}
+\indexentry{K}{111}
+\indexentry{L}{112}
+\indexentry{LL}{161}
+\indexentry{M}{113}
+\indexentry{N}{114}
+\indexentry{Ñ}{162}
+\indexentry{O}{115}
+\indexentry{P}{116}
+\indexentry{Q}{117}
+\indexentry{R}{118}
+\indexentry{S}{119}
+\indexentry{T}{120}
+\indexentry{U}{121}
+\indexentry{V}{122}
+\indexentry{W}{123}
+\indexentry{X}{124}
+\indexentry{Y}{125}
+\indexentry{Z}{126}
+\indexentry{a}{201}
+\indexentry{b}{202}
+\indexentry{c}{203}
+\indexentry{ch}{260}
+\indexentry{d}{204}
+\indexentry{e}{205}
+\indexentry{f}{206}
+\indexentry{g}{207}
+\indexentry{h}{208}
+\indexentry{i}{209}
+\indexentry{j}{210}
+\indexentry{k}{211}
+\indexentry{l}{212}
+\indexentry{ll}{261}
+\indexentry{m}{213}
+\indexentry{n}{214}
+\indexentry{ñ}{262}
+\indexentry{o}{215}
+\indexentry{p}{216}
+\indexentry{q}{217}
+\indexentry{r}{218}
+\indexentry{s}{219}
+\indexentry{t}{220}
+\indexentry{u}{221}
+\indexentry{v}{222}
+\indexentry{w}{223}
+\indexentry{x}{224}
+\indexentry{y}{225}
+\indexentry{z}{226}
+\indexentry{ca}{1000}
+\indexentry{cg}{1001}
+\indexentry{ci}{1002}
+\indexentry{cz}{1003}
+\indexentry{cha}{1004}
+\indexentry{chz}{1005}
+\indexentry{la}{2000}
+\indexentry{lk}{2001}
+\indexentry{lm}{2001}
+\indexentry{lz}{2001}
+\indexentry{lla}{2004}
+\indexentry{llz}{2005}
+\indexentry{na}{3000}
+\indexentry{nz}{3001}
+\indexentry{ña}{3002}
+\indexentry{ñz}{3003}
+\indexentry{ra}{4000}
+\indexentry{rq}{4001}
+\indexentry{rs}{4002}
+\indexentry{rz}{4003}
+\indexentry{rr}{4004}
+\indexentry{rra}{4005}
+\indexentry{rrz}{4006}
+\indexentry{ga}{5000}
+\indexentry{gt}{5001}
+\indexentry{gv}{5002}
+\indexentry{gz}{5003}
+\indexentry{gu}{5004}
+\indexentry{gua}{5005}
+\indexentry{guz}{5006}
+\indexentry{qa}{6000}
+\indexentry{qt}{6001}
+\indexentry{qv}{6002}
+\indexentry{qz}{6003}
+\indexentry{qu}{6004}
+\indexentry{qua}{6005}
+\indexentry{quz}{6006}
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zh.idx b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zh.idx
new file mode 100644
index 00000000000..1e7845cb47d
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zh.idx
@@ -0,0 +1,86 @@
+\indexentry{一 (1, 一, yī, ㄧ)}{101}
+\indexentry{二 (2, 二, èr, ㄦˋ)}{102}
+\indexentry{三 (3, 一, sān, ㄙㄢ)}{103}
+\indexentry{四 (5, 囗, sì, ㄙˋ)}{104}
+\indexentry{五 (4, 二, wǔ, ㄨˇ)}{105}
+\indexentry{六 (4, 八, liù, ㄌㄧㄡˋ)}{106}
+\indexentry{七 (2, 一, qī, ㄑㄧ)}{160}
+\indexentry{八 (2, 八, bā, ㄅㄚ)}{107}
+\indexentry{九 (2, 乙, jiǔ, ㄐㄧㄡˇ)}{108}
+\indexentry{十 (2, 十, shí, ㄕˊ)}{161}
+\indexentry{百 (6, 白, bǎi, ㄅㄞˇ)}{202}
+\indexentry{千 (3, 十, qiān, ㄑㄧㄢ)}{203}
+\indexentry{万 (3, 一, wàn, ㄨㄢˋ)}{204}
+\indexentry{億 (15, 人, yì, ㄧˋ)}{205}
+\indexentry{兆 (6, 儿, zhào, ㄓㄠˋ)}{206}
+\indexentry{京 (8, 亠, jīng, ㄐㄧㄥ)}{260}
+\indexentry{春 (9, 日, chūn, ㄔㄨㄣ)}{110}
+\indexentry{夏 (10, 夊, xià, ㄒㄧㄚˋ)}{111}
+\indexentry{秋 (9, 禾, qiū, ㄑㄧㄡ)}{112}
+\indexentry{冬 (5, 冫, dōng, ㄉㄨㄥ)}{113}
+\indexentry{月 (4, 月, yuè, ㄩㄝˋ)}{114}
+\indexentry{火 (4, 火, huǒ, ㄏㄨㄛˇ)}{115}
+\indexentry{水 (4, 水, shuǐ, ㄕㄨㄟˇ)}{116}
+\indexentry{木 (4, 木, mù, ㄇㄨˋ)}{117}
+\indexentry{金 (8, 金, jīn, ㄐㄧㄣ)}{118}
+\indexentry{土 (3, 土, tǔ, ㄊㄨˇ)}{119}
+\indexentry{日 (4, 日, rì, ㄖˋ)}{120}
+\indexentry{子 (3, 子, zǐ, ㄗˇ)}{162}
+\indexentry{丑 (4, 一, chǒu, ㄔㄡˇ)}{121}
+\indexentry{寅 (11, 宀, yín, ㄧㄣˊ)}{122}
+\indexentry{卯 (5, 卩, mǎo, ㄇㄠˇ)}{123}
+\indexentry{辰 (7, 辰, chén, ㄔㄣˊ)}{124}
+\indexentry{巳 (3, 己, sì, ㄙˋ)}{125}
+\indexentry{午 (4, 十, wǔ, ㄨˇ)}{128}
+\indexentry{未 (5, 木, wèi, ㄨㄟˋ)}{129}
+\indexentry{申 (5, 田, shēn, ㄕㄣ)}{130}
+\indexentry{酉 (7, 酉, yǒu, ㄧㄡˇ)}{131}
+\indexentry{戌 (6, 戈, xū, ㄒㄩ)}{132}
+\indexentry{亥 (6, 亠, hài, ㄏㄞˋ)}{201}
+\indexentry{甲 (5, 田, jiǎ, ㄐㄧㄚˇ)}{207}
+\indexentry{乙 (1, 乙, yǐ, ㄧˇ)}{208}
+\indexentry{丙 (5, 一, bǐng, ㄅㄧㄥˇ)}{261}
+\indexentry{丁 (2, 一, dīng, ㄉㄧㄥ)}{210}
+\indexentry{戊 (5, 戈, wù, ㄨˋ)}{211}
+\indexentry{己 (3, 己, jǐ, ㄐㄧˇ)}{212}
+\indexentry{庚 (8, 广, gēng, ㄍㄥ)}{213}
+\indexentry{辛 (7, 辛, xīn, ㄒㄧㄣ)}{214}
+\indexentry{壬 (4, 士, rén, ㄖㄣˊ)}{215}
+\indexentry{癸 (9, 癶, guǐ, ㄍㄨㄟˇ)}{216}
+\indexentry{東 (8, 木, dōng, ㄉㄨㄥ)}{217}
+\indexentry{西 (6, 襾, xī, ㄒㄧ)}{218}
+\indexentry{南 (9, 十, nán, ㄋㄢˊ)}{219}
+\indexentry{北 (5, 匕, běi, ㄅㄟˇ)}{220}
+\indexentry{靑 (8, 靑, qīng, ㄑㄧㄥ)}{221}
+\indexentry{赤 (7, 赤, chì, ㄔˋ)}{222}
+\indexentry{黃 (12, 黃, huáng, ㄏㄨㄤˊ)}{223}
+\indexentry{白 (5, 白, bái, ㄅㄞˊ)}{224}
+\indexentry{黑 (12, 黑, hēi, ㄏㄟ)}{225}
+\indexentry{喜 (12, 口, xǐ, ㄒㄧˇ)}{226}
+\indexentry{怒 (9, 心, nù, ㄋㄨˋ)}{227}
+\indexentry{哀 (9, 口, āi, ㄞ)}{228}
+\indexentry{樂 (15, 木, lè, ㄌㄜˋ)}{229}
+\indexentry{花 (8, 艸, huā, ㄏㄨㄚ)}{230}
+\indexentry{鳥 (11, 鳥, niǎo, ㄋㄧㄠˇ)}{231}
+\indexentry{風 (9, 風, fēng, ㄈㄥ)}{232}
+\indexentry{月 (4, 月, yuè, ㄩㄝˋ)}{233}
+\indexentry{天 (4, 大, tiān, ㄊㄧㄢ)}{234}
+\indexentry{馬 (10, 馬, mǎ, ㄇㄚˇ)}{235}
+\indexentry{行 (6, 行, xíng, ㄒㄧㄥˊ)}{236}
+\indexentry{空 (8, 穴, kōng, ㄎㄨㄥ)}{237}
+\indexentry{品 (9, 口, pǐn, ㄆㄧㄣˇ)}{238}
+\indexentry{行 (6, 行, xíng, ㄒㄧㄥˊ)}{239}
+\indexentry{方 (4, 方, fāng, ㄈㄤ)}{240}
+\indexentry{正 (5, 止, zhèng, ㄓㄥˋ)}{241}
+\indexentry{海 (10, 水, hǎi, ㄏㄞˇ)}{242}
+\indexentry{翁 (10, 羽, wēng, ㄨㄥ)}{243}
+\indexentry{好 (6, 女, hǎo, ㄏㄠˇ)}{244}
+\indexentry{鷗 (22, 鳥, ōu, ㄡ)}{245}
+\indexentry{安 (6, 宀, ān, ㄢ)}{246}
+\indexentry{心 (4, 心, xīn, ㄒㄧㄣ)}{247}
+\indexentry{立 (5, 立, lì, ㄌㄧˋ)}{248}
+\indexentry{命 (8, 口, mìng, ㄇㄧㄥˋ)}{249}
+\indexentry{勸 (19, 力, quàn, ㄑㄩㄢˋ)}{250}
+\indexentry{善 (12, 口, shàn, ㄕㄢˋ)}{251}
+\indexentry{懲 (19, 心, chéng, ㄔㄥˊ)}{252}
+\indexentry{惡 (12, 心, è, ㄜˋ)}{253}
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhp.idx b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhp.idx
new file mode 100644
index 00000000000..d7d537f96ee
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhp.idx
@@ -0,0 +1,86 @@
+\indexentry{一}{101}
+\indexentry{二}{102}
+\indexentry{三}{103}
+\indexentry{四}{104}
+\indexentry{五}{105}
+\indexentry{六}{106}
+\indexentry{七}{160}
+\indexentry{八}{107}
+\indexentry{九}{108}
+\indexentry{十}{161}
+\indexentry{百}{202}
+\indexentry{千}{203}
+\indexentry{万}{204}
+\indexentry{億}{205}
+\indexentry{兆}{206}
+\indexentry{京}{260}
+\indexentry{春}{110}
+\indexentry{夏}{111}
+\indexentry{秋}{112}
+\indexentry{冬}{113}
+\indexentry{月}{114}
+\indexentry{火}{115}
+\indexentry{水}{116}
+\indexentry{木}{117}
+\indexentry{金}{118}
+\indexentry{土}{119}
+\indexentry{日}{120}
+\indexentry{子}{162}
+\indexentry{丑}{121}
+\indexentry{寅}{122}
+\indexentry{卯}{123}
+\indexentry{辰}{124}
+\indexentry{巳{125}
+\indexentry{午}{128}
+\indexentry{未}{129}
+\indexentry{申}{130}
+\indexentry{酉}{131}
+\indexentry{戌}{132}
+\indexentry{亥}{201}
+\indexentry{甲}{207}
+\indexentry{乙}{208}
+\indexentry{丙}{261}
+\indexentry{丁}{210}
+\indexentry{戊}{211}
+\indexentry{己}{212}
+\indexentry{庚}{213}
+\indexentry{辛}{214}
+\indexentry{壬}{215}
+\indexentry{癸}{216}
+\indexentry{東}{217}
+\indexentry{西}{218}
+\indexentry{南}{219}
+\indexentry{北}{220}
+\indexentry{靑}{221}
+\indexentry{赤}{222}
+\indexentry{黃}{223}
+\indexentry{白}{224}
+\indexentry{黑}{225}
+\indexentry{喜}{226}
+\indexentry{怒}{227}
+\indexentry{哀}{228}
+\indexentry{樂}{229}
+\indexentry{花}{230}
+\indexentry{鳥}{231}
+\indexentry{風}{232}
+\indexentry{月}{233}
+\indexentry{天}{234}
+\indexentry{馬}{235}
+\indexentry{行}{236}
+\indexentry{空}{237}
+\indexentry{品}{238}
+\indexentry{行}{239}
+\indexentry{方}{240}
+\indexentry{正}{241}
+\indexentry{海}{242}
+\indexentry{翁}{243}
+\indexentry{好}{244}
+\indexentry{鷗}{245}
+\indexentry{安}{246}
+\indexentry{心}{247}
+\indexentry{立}{248}
+\indexentry{命}{249}
+\indexentry{勸}{250}
+\indexentry{善}{251}
+\indexentry{懲}{252}
+\indexentry{惡}{253}
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhr.idx b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhr.idx
new file mode 100644
index 00000000000..606df2c52ec
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhr.idx
@@ -0,0 +1,214 @@
+\indexentry{一}{1}
+\indexentry{丨}{2}
+\indexentry{丶}{3}
+\indexentry{丿}{4}
+\indexentry{乙}{5}
+\indexentry{亅}{6}
+\indexentry{二}{7}
+\indexentry{亠}{8}
+\indexentry{人}{9}
+\indexentry{儿}{10}
+\indexentry{入}{11}
+\indexentry{八}{12}
+\indexentry{冂}{13}
+\indexentry{冖}{14}
+\indexentry{冫}{15}
+\indexentry{几}{16}
+\indexentry{凵}{17}
+\indexentry{刀}{18}
+\indexentry{力}{19}
+\indexentry{勹}{10}
+\indexentry{匕}{11}
+\indexentry{匚}{12}
+\indexentry{匸}{13}
+\indexentry{十}{14}
+\indexentry{卜}{15}
+\indexentry{卩}{16}
+\indexentry{厂}{17}
+\indexentry{厶}{18}
+\indexentry{又}{19}
+\indexentry{口}{10}
+\indexentry{囗}{11}
+\indexentry{土}{12}
+\indexentry{士}{13}
+\indexentry{夂}{14}
+\indexentry{夊}{15}
+\indexentry{夕}{16}
+\indexentry{大}{17}
+\indexentry{女}{18}
+\indexentry{子}{19}
+\indexentry{宀}{10}
+\indexentry{寸}{11}
+\indexentry{小}{12}
+\indexentry{尢}{13}
+\indexentry{尸}{14}
+\indexentry{屮}{15}
+\indexentry{山}{16}
+\indexentry{巛}{17}
+\indexentry{工}{18}
+\indexentry{己}{19}
+\indexentry{巾}{10}
+\indexentry{干}{11}
+\indexentry{幺}{12}
+\indexentry{广}{13}
+\indexentry{廴}{14}
+\indexentry{廾}{15}
+\indexentry{弋}{16}
+\indexentry{弓}{17}
+\indexentry{彐}{18}
+\indexentry{彡}{19}
+\indexentry{彳}{10}
+\indexentry{心}{11}
+\indexentry{戈}{12}
+\indexentry{戶}{13}
+\indexentry{手}{14}
+\indexentry{支}{15}
+\indexentry{攴}{16}
+\indexentry{文}{17}
+\indexentry{斗}{18}
+\indexentry{斤}{19}
+\indexentry{方}{10}
+\indexentry{无}{11}
+\indexentry{日}{12}
+\indexentry{曰}{13}
+\indexentry{月}{14}
+\indexentry{木}{15}
+\indexentry{欠}{16}
+\indexentry{止}{17}
+\indexentry{歹}{18}
+\indexentry{殳}{19}
+\indexentry{毋}{10}
+\indexentry{比}{11}
+\indexentry{毛}{12}
+\indexentry{氏}{13}
+\indexentry{气}{14}
+\indexentry{水}{15}
+\indexentry{火}{16}
+\indexentry{爪}{17}
+\indexentry{父}{18}
+\indexentry{爻}{19}
+\indexentry{爿}{10}
+\indexentry{片}{11}
+\indexentry{牙}{12}
+\indexentry{牛}{13}
+\indexentry{犬}{14}
+\indexentry{玄}{15}
+\indexentry{玉}{16}
+\indexentry{瓜}{17}
+\indexentry{瓦}{18}
+\indexentry{甘}{19}
+\indexentry{生}{10}
+\indexentry{用}{11}
+\indexentry{田}{12}
+\indexentry{疋}{13}
+\indexentry{疒}{14}
+\indexentry{癶}{15}
+\indexentry{白}{16}
+\indexentry{皮}{17}
+\indexentry{皿}{18}
+\indexentry{目}{19}
+\indexentry{矛}{10}
+\indexentry{矢}{11}
+\indexentry{石}{12}
+\indexentry{示}{13}
+\indexentry{禸}{14}
+\indexentry{禾}{15}
+\indexentry{穴}{16}
+\indexentry{立}{17}
+\indexentry{竹}{18}
+\indexentry{米}{19}
+\indexentry{糸}{10}
+\indexentry{缶}{11}
+\indexentry{网}{12}
+\indexentry{羊}{13}
+\indexentry{羽}{14}
+\indexentry{老}{15}
+\indexentry{而}{16}
+\indexentry{耒}{17}
+\indexentry{耳}{18}
+\indexentry{聿}{19}
+\indexentry{肉}{10}
+\indexentry{臣}{11}
+\indexentry{自}{12}
+\indexentry{至}{13}
+\indexentry{臼}{14}
+\indexentry{舌}{15}
+\indexentry{舛}{16}
+\indexentry{舟}{17}
+\indexentry{艮}{18}
+\indexentry{色}{19}
+\indexentry{艸}{10}
+\indexentry{虍}{11}
+\indexentry{虫}{12}
+\indexentry{血}{13}
+\indexentry{行}{14}
+\indexentry{衣}{15}
+\indexentry{襾}{16}
+\indexentry{見}{17}
+\indexentry{角}{18}
+\indexentry{言}{19}
+\indexentry{谷}{10}
+\indexentry{豆}{11}
+\indexentry{豕}{12}
+\indexentry{豸}{13}
+\indexentry{貝}{14}
+\indexentry{赤}{15}
+\indexentry{走}{16}
+\indexentry{足}{17}
+\indexentry{身}{18}
+\indexentry{車}{19}
+\indexentry{辛}{10}
+\indexentry{辰}{11}
+\indexentry{辵}{12}
+\indexentry{邑}{13}
+\indexentry{酉}{14}
+\indexentry{釆}{15}
+\indexentry{里}{16}
+\indexentry{金}{17}
+\indexentry{長}{18}
+\indexentry{門}{19}
+\indexentry{阜}{10}
+\indexentry{隶}{11}
+\indexentry{隹}{12}
+\indexentry{雨}{13}
+\indexentry{靑}{14}
+\indexentry{非}{15}
+\indexentry{面}{16}
+\indexentry{革}{17}
+\indexentry{韋}{18}
+\indexentry{韭}{19}
+\indexentry{音}{10}
+\indexentry{頁}{11}
+\indexentry{風}{12}
+\indexentry{飛}{13}
+\indexentry{食}{14}
+\indexentry{首}{15}
+\indexentry{香}{16}
+\indexentry{馬}{17}
+\indexentry{骨}{18}
+\indexentry{高}{19}
+\indexentry{髟}{10}
+\indexentry{鬥}{11}
+\indexentry{鬯}{12}
+\indexentry{鬲}{13}
+\indexentry{鬼}{14}
+\indexentry{魚}{15}
+\indexentry{鳥}{16}
+\indexentry{鹵}{17}
+\indexentry{鹿}{18}
+\indexentry{麥}{19}
+\indexentry{麻}{10}
+\indexentry{黃}{11}
+\indexentry{黍}{12}
+\indexentry{黑}{13}
+\indexentry{黹}{14}
+\indexentry{黽}{15}
+\indexentry{鼎}{16}
+\indexentry{鼓}{17}
+\indexentry{鼠}{18}
+\indexentry{鼻}{19}
+\indexentry{齊}{10}
+\indexentry{齒}{11}
+\indexentry{龍}{12}
+\indexentry{龜}{13}
+\indexentry{龠}{14}
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhs.idx b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhs.idx
new file mode 100644
index 00000000000..990a30acd49
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhs.idx
@@ -0,0 +1,58 @@
+\indexentry{一}{1}
+\indexentry{乙}{1}
+\indexentry{二}{2}
+\indexentry{力}{2}
+\indexentry{三}{3}
+\indexentry{山}{3}
+\indexentry{中}{4}
+\indexentry{日}{4}
+\indexentry{目}{5}
+\indexentry{古}{5}
+\indexentry{名}{6}
+\indexentry{多}{6}
+\indexentry{努}{7}
+\indexentry{君}{7}
+\indexentry{京}{8}
+\indexentry{宝}{8}
+\indexentry{信}{9}
+\indexentry{品}{9}
+\indexentry{夏}{10}
+\indexentry{宮}{10}
+\indexentry{商}{11}
+\indexentry{彩}{11}
+\indexentry{最}{12}
+\indexentry{晶}{12}
+\indexentry{勢}{13}
+\indexentry{源}{13}
+\indexentry{態}{14}
+\indexentry{語}{14}
+\indexentry{影}{15}
+\indexentry{暴}{15}
+\indexentry{壁}{16}
+\indexentry{橋}{16}
+\indexentry{優}{17}
+\indexentry{懇}{17}
+\indexentry{職}{18}
+\indexentry{題}{18}
+\indexentry{願}{19}
+\indexentry{鏡}{19}
+\indexentry{競}{20}
+\indexentry{議}{20}
+\indexentry{露}{21}
+\indexentry{躍}{21}
+\indexentry{襲}{22}
+\indexentry{鑑}{23}
+\indexentry{鹼}{24}
+\indexentry{灣}{25}
+\indexentry{驢}{26}
+\indexentry{纜}{27}
+\indexentry{鑿}{28}
+\indexentry{鬱}{29}
+\indexentry{鸞}{30}
+\indexentry{灩}{31}
+\indexentry{龖}{32}
+\indexentry{龗}{33}
+\indexentry{齾}{35}
+\indexentry{齉}{36}
+\indexentry{靐}{39}
+\indexentry{龘}{48}
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhz.idx b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhz.idx
new file mode 100644
index 00000000000..55ef3df56f4
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/alpha_zhz.idx
@@ -0,0 +1,97 @@
+\indexentry{一}{101}
+\indexentry{二}{102}
+\indexentry{三}{103}
+\indexentry{四}{104}
+\indexentry{五}{105}
+\indexentry{六}{106}
+\indexentry{七}{160}
+\indexentry{八}{107}
+\indexentry{九}{108}
+\indexentry{十}{161}
+\indexentry{百}{202}
+\indexentry{千}{203}
+\indexentry{万}{204}
+\indexentry{億}{205}
+\indexentry{兆}{206}
+\indexentry{京}{260}
+\indexentry{春}{110}
+\indexentry{夏}{111}
+\indexentry{秋}{112}
+\indexentry{冬}{113}
+\indexentry{月}{114}
+\indexentry{火}{115}
+\indexentry{水}{116}
+\indexentry{木}{117}
+\indexentry{金}{118}
+\indexentry{土}{119}
+\indexentry{日}{120}
+\indexentry{子}{162}
+\indexentry{丑}{121}
+\indexentry{寅}{122}
+\indexentry{卯}{123}
+\indexentry{辰}{124}
+\indexentry{巳{125}
+\indexentry{午}{128}
+\indexentry{未}{129}
+\indexentry{申}{130}
+\indexentry{酉}{131}
+\indexentry{戌}{132}
+\indexentry{亥}{201}
+\indexentry{甲}{207}
+\indexentry{乙}{208}
+\indexentry{丙}{261}
+\indexentry{丁}{210}
+\indexentry{戊}{211}
+\indexentry{己}{212}
+\indexentry{庚}{213}
+\indexentry{辛}{214}
+\indexentry{壬}{215}
+\indexentry{癸}{216}
+\indexentry{東}{217}
+\indexentry{西}{218}
+\indexentry{南}{219}
+\indexentry{北}{220}
+\indexentry{靑}{221}
+\indexentry{赤}{222}
+\indexentry{黃}{223}
+\indexentry{白}{224}
+\indexentry{黑}{225}
+\indexentry{喜}{226}
+\indexentry{怒}{227}
+\indexentry{哀}{228}
+\indexentry{樂}{229}
+\indexentry{花}{230}
+\indexentry{鳥}{231}
+\indexentry{風}{232}
+\indexentry{月}{233}
+\indexentry{天}{234}
+\indexentry{馬}{235}
+\indexentry{行}{236}
+\indexentry{空}{237}
+\indexentry{品}{238}
+\indexentry{行}{239}
+\indexentry{方}{240}
+\indexentry{正}{241}
+\indexentry{海}{242}
+\indexentry{翁}{243}
+\indexentry{好}{244}
+\indexentry{鷗}{245}
+\indexentry{安}{246}
+\indexentry{心}{247}
+\indexentry{立}{248}
+\indexentry{命}{249}
+\indexentry{勸}{250}
+\indexentry{善}{251}
+\indexentry{懲}{252}
+\indexentry{惡}{253}
+\indexentry{恩}{1002}
+\indexentry{蒽}{1003}
+\indexentry{骯}{1004}
+\indexentry{卬}{1005}
+\indexentry{鞥}{1006}
+\indexentry{阿}{1007}
+\indexentry{嗄}{1008}
+\indexentry{哦}{1009}
+\indexentry{喔}{1010}
+\indexentry{次}{1014}
+\indexentry{促}{1015}
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es1.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es1.ist
new file mode 100644
index 00000000000..1c82c1edfae
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es1.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es11.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es11.ist
new file mode 100644
index 00000000000..bcf1b788f8e
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es11.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es@collation=traditional"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es12.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es12.ist
new file mode 100644
index 00000000000..bef0b6f818f
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es12.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag -1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es@collation=traditional"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es13.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es13.ist
new file mode 100644
index 00000000000..804b137c967
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es13.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 2
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es@collation=traditional"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es2.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es2.ist
new file mode 100644
index 00000000000..194545e04f3
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es2.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag -1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es21.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es21.ist
new file mode 100644
index 00000000000..119652482cb
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es21.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es@collation=search"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es22.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es22.ist
new file mode 100644
index 00000000000..b9c13151f70
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es22.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag -1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es@collation=search"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es23.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es23.ist
new file mode 100644
index 00000000000..8f9890b0718
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_es23.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 2
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "es@collation=search"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh1.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh1.ist
new file mode 100644
index 00000000000..e52cb7910c3
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh1.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh11.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh11.ist
new file mode 100644
index 00000000000..4f4661ec8e8
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh11.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh@collation=unihan"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh12.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh12.ist
new file mode 100644
index 00000000000..f2e8c0aa87a
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh12.ist
@@ -0,0 +1,13 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh@collation=unihan"
+hanzi_head  "一部;丨部;丶部;丿部;乙部;亅部;二部;亠部;人部;儿部;入部;八部;冂部;冖部;冫部;几部;凵部;刀部;力部;勹部;匕部;匚部;匸部;十部;卜部;卩部;厂部;厶部;又部;口部;囗部;土部;士部;夂部;夊部;夕部;大部;女部;子部;宀部;寸部;小部;尢部;尸部;屮部;山部;巛部;工部;己部;巾部;干部;幺部;广部;廴部;廾部;弋部;弓部;彐部;彡部;彳部;心部;戈部;戶部;手部;支部;攴部;文部;斗部;斤部;方部;无部;日部;曰部;月部;木部;欠部;止部;歹部;殳部;毋部;比部;毛部;氏部;气部;水部;火部;爪部;父部;爻部;爿部;片部;牙部;牛部;犬部;玄部;玉部;瓜部;瓦部;甘部;生部;用部;田部;疋部;疒部;癶部;白部;皮部;皿部;目部;矛部;矢部;石部;示部;禸部;禾部;穴部;立部;竹部;米部;糸部;缶部;网部;羊部;羽部;老部;而部;耒部;耳部;聿部;肉部;臣部;自部;至部;臼部;舌部;舛部;舟部;艮部;色部;艸部;虍部;虫部;血部;行部;衣部;襾部;見部;角部;言部;谷部;豆部;豕部;豸部;貝部;赤部;走部;足部;身部;車部;辛部;辰部;辵部;邑部;酉部;釆部;里部;金部;長部;門部;阜部;隶部;隹部;雨部;靑部;非部;面部;革部;韋部;韭部;音部;頁部;風部;飛部;食部;首部;香部;馬部;骨部;高部;髟部;鬥部;鬯部;鬲部;鬼部;魚部;鳥部;鹵部;鹿部;麥部;麻部;黃部;黍部;黑部;黹部;黽部;鼎部;鼓部;鼠部;鼻部;齊部;齒部;龍部;龜部;龠部"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh13.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh13.ist
new file mode 100644
index 00000000000..6fce8ee43c0
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh13.ist
@@ -0,0 +1,13 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "ja@collation=unihan"
+hanzi_head  "一部;丨部;丶部;丿部;乙部;亅部;二部;亠部;人部;儿部;入部;八部;冂部;冖部;冫部;几部;凵部;刀部;力部;勹部;匕部;匚部;匸部;十部;卜部;卩部;厂部;厶部;又部;口部;囗部;土部;士部;夂部;夊部;夕部;大部;女部;子部;宀部;寸部;小部;尢部;尸部;屮部;山部;巛部;工部;己部;巾部;干部;幺部;广部;廴部;廾部;弋部;弓部;彐部;彡部;彳部;心部;戈部;戸部;手部;支部;攴部;文部;斗部;斤部;方部;无部;日部;曰部;月部;木部;欠部;止部;歹部;殳部;毋部;比部;毛部;氏部;气部;水部;火部;爪部;父部;爻部;爿部;片部;牙部;牛部;犬部;玄部;玉部;瓜部;瓦部;甘部;生部;用部;田部;疋部;疒部;癶部;白部;皮部;皿部;目部;矛部;矢部;石部;示部;禸部;禾部;穴部;立部;竹部;米部;糸部;缶部;网部;羊部;羽部;老部;而部;耒部;耳部;聿部;肉部;臣部;自部;至部;臼部;舌部;舛部;舟部;艮部;色部;艸部;虍部;虫部;血部;行部;衣部;襾部;見部;角部;言部;谷部;豆部;豕部;豸部;貝部;赤部;走部;足部;身部;車部;辛部;辰部;辵部;邑部;酉部;釆部;里部;金部;長部;門部;阜部;隶部;隹部;雨部;靑部;非部;面部;革部;韋部;韭部;音部;頁部;風部;飛部;食部;首部;香部;馬部;骨部;高部;髟部;鬥部;鬯部;鬲部;鬼部;魚部;鳥部;鹵部;鹿部;麥部;麻部;黃部;黍部;黑部;黹部;黽部;鼎部;鼓部;鼠部;鼻部;齊部;齒部;龍部;龜部;龠部"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh14.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh14.ist
new file mode 100644
index 00000000000..7e92ed574f7
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh14.ist
@@ -0,0 +1,13 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "ko@collation=unihan"
+hanzi_head  "一部;丨部;丶部;丿部;乙部;亅部;二部;亠部;人部;儿部;入部;八部;冂部;冖部;冫部;几部;凵部;刀部;力部;勹部;匕部;匚部;匸部;十部;卜部;卩部;厂部;厶部;又部;口部;囗部;土部;士部;夂部;夊部;夕部;大部;女部;子部;宀部;寸部;小部;尢部;尸部;屮部;山部;巛部;工部;己部;巾部;干部;幺部;广部;廴部;廾部;弋部;弓部;彐部;彡部;彳部;心部;戈部;戶部;手部;支部;攴部;文部;斗部;斤部;方部;无部;日部;曰部;月部;木部;欠部;止部;歹部;殳部;毋部;比部;毛部;氏部;气部;水部;火部;爪部;父部;爻部;爿部;片部;牙部;牛部;犬部;玄部;玉部;瓜部;瓦部;甘部;生部;用部;田部;疋部;疒部;癶部;白部;皮部;皿部;目部;矛部;矢部;石部;示部;禸部;禾部;穴部;立部;竹部;米部;糸部;缶部;网部;羊部;羽部;老部;而部;耒部;耳部;聿部;肉部;臣部;自部;至部;臼部;舌部;舛部;舟部;艮部;色部;艸部;虍部;虫部;血部;行部;衣部;襾部;見部;角部;言部;谷部;豆部;豕部;豸部;貝部;赤部;走部;足部;身部;車部;辛部;辰部;辵部;邑部;酉部;釆部;里部;金部;長部;門部;阜部;隶部;隹部;雨部;靑部;非部;面部;革部;韋部;韭部;音部;頁部;風部;飛部;食部;首部;香部;馬部;骨部;高部;髟部;鬥部;鬯部;鬲部;鬼部;魚部;鳥部;鹵部;鹿部;麥部;麻部;黃部;黍部;黑部;黹部;黽部;鼎部;鼓部;鼠部;鼻部;齊部;齒部;龍部;龜部;龠部"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh2.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh2.ist
new file mode 100644
index 00000000000..359f3b97bde
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh2.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag -1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh21.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh21.ist
new file mode 100644
index 00000000000..499dcf9eff3
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh21.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh@collation=stroke"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh22.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh22.ist
new file mode 100644
index 00000000000..6cc7d3252ca
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh22.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh@collation=stroke"
+hanzi_head  "1画;2画;3画;4画;5画;6画;7画;8画;9画;10画;11画;12画;13画;14画;15画;16画;17画;18画;19画;20画;21画;22画;23画;24画;25画;26画;27画;28画;29画;30画;31画;32画;33画;35画;36画;39画;48画"
diff --git a/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh31.ist b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh31.ist
new file mode 100644
index 00000000000..c3584031e7c
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/alphabet/mdxsty_zh31.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+icu_locale  "zh@collation=zhuyin"
+
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/Makefile b/Master/texmf-dist/doc/upmendex/samples/option/Makefile
new file mode 100644
index 00000000000..8e2746d17c1
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/Makefile
@@ -0,0 +1,22 @@
+UPMENDEX = upmendex
+
+#
+# test for icu_rules
+#
+rules:
+	for sty in rule0; do \
+		$(UPMENDEX) -f attri1.idx -s mdxsty_$$sty.ist -o attri1_$$sty.ind ; \
+	done
+
+#
+# test for Japanese
+#
+jp_u:
+	for sty in 00 01 02; do \
+		$(UPMENDEX) japanese.idx -s mdxsty_j$$sty.ist -o japanese_$$sty-umdx.ind ; \
+		$(UPMENDEX) japanese.idx -l -s mdxsty_j$$sty.ist -o japanese_l_$$sty-umdx.ind ; \
+		$(UPMENDEX) japanese.idx -c -s mdxsty_j$$sty.ist -o japanese_c_$$sty-umdx.ind ; \
+		$(UPMENDEX) japanese.idx -l -c -s mdxsty_j$$sty.ist -o japanese_lc_$$sty-umdx.ind ; \
+		$(UPMENDEX) japanese.idx -r -s mdxsty_j$$sty.ist -o japanese_r_$$sty-umdx.ind ; \
+		$(UPMENDEX) japanese.idx -g -s mdxsty_j$$sty.ist -o japanese_g_$$sty-umdx.ind ; \
+	done
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/attri1.idx b/Master/texmf-dist/doc/upmendex/samples/option/attri1.idx
new file mode 100644
index 00000000000..a470ffab42e
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/attri1.idx
@@ -0,0 +1,42 @@
+% -*- coding: utf-8 -*-
+\indexentry{delug}{100}
+\indexentry{de-luge}{101}
+\indexentry{delu-ge}{102}
+\indexentry{deluge}{103}
+\indexentry{Deluge}{104}
+\indexentry{deluge-}{105}
+\indexentry{cote}{200}
+\indexentry{coté}{201}
+\indexentry{côte}{202}
+\indexentry{côté}{203}
+\indexentry{black bird}{300}
+\indexentry{black Bird}{301}
+\indexentry{black birds}{302}
+\indexentry{black-bird}{303}
+\indexentry{black-Bird}{304}
+\indexentry{black-birds}{305}
+\indexentry{blackbird}{306}
+\indexentry{blackBird}{307}
+\indexentry{blackbirds}{308}
+\indexentry{A}{400}
+\indexentry{a}{401}
+\indexentry{Ä}{402}
+\indexentry{ä}{403}
+\indexentry{Å}{404}
+\indexentry{å}{405}
+\indexentry{B}{406}
+\indexentry{b}{407}
+\indexentry{E}{408}
+\indexentry{e}{409}
+\indexentry{Ë}{410}
+\indexentry{ë}{411}
+\indexentry{あいうえお}{500}
+\indexentry{アイウエオ}{501}
+\indexentry{アイうえお}{502}
+\indexentry{あいウエオ}{503}
+\indexentry{あイうエお}{504}
+\indexentry{アいウえオ}{505}
+\indexentry{いいいいい}{506}
+\indexentry{イイイイイ}{507}
+\indexentry{い}{508}
+\indexentry{イ}{509}
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/japanese.idx b/Master/texmf-dist/doc/upmendex/samples/option/japanese.idx
new file mode 100644
index 00000000000..f0f6f8ac14a
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/japanese.idx
@@ -0,0 +1,34 @@
+% -*- coding: utf-8 -*-
+\indexentry{とうきょう}{1}
+\indexentry{ソウル}{1}
+\indexentry{ペキン}{1}
+\indexentry{ワルシャワ}{1}
+\indexentry{ヰーン}{1}
+\indexentry{ヱリントン}{1}
+\indexentry{ンジャメナ}{1}
+\indexentry{Xlib}{100}
+\indexentry{XView}{101}
+\indexentry{X Window}{102}
+\indexentry{X  X}{102}
+\indexentry{X  V}{102}
+\indexentry{X  T }{102}
+\indexentry{X  s}{102}
+\indexentry{X  		s}{103}
+\indexentry{index sort}{200}
+\indexentry{indファイル}{201}
+\indexentry{ind file}{202}
+\indexentry{か}{1}
+\indexentry{カ}{2}
+\indexentry{かかか}{3}
+\indexentry{かかか}{4}
+\indexentry{かかか}{5}
+\indexentry{かかか}{7}
+\indexentry{かかか}{8--10}
+\indexentry{カカカ}{20}
+\indexentry{カカカ}{21}
+\indexentry{A}{4001}
+\indexentry{B}{4002}
+\indexentry{C}{4003}
+\indexentry{Ａ}{4004}
+\indexentry{Ｂ}{4005}
+\indexentry{Ｃ}{4006}
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j00.ist b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j00.ist
new file mode 100644
index 00000000000..93ca3f5c151
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j00.ist
@@ -0,0 +1,11 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+priority 0
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j01.ist b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j01.ist
new file mode 100644
index 00000000000..b3b09443012
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j01.ist
@@ -0,0 +1,11 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+priority 1
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j02.ist b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j02.ist
new file mode 100644
index 00000000000..3b084ba9d8e
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_j02.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+priority 1
+letter_head 2
diff --git a/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_rule0.ist b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_rule0.ist
new file mode 100644
index 00000000000..451656ba59d
--- /dev/null
+++ b/Master/texmf-dist/doc/upmendex/samples/option/mdxsty_rule0.ist
@@ -0,0 +1,12 @@
+% -*- coding: utf-8 -*-
+
+delim_0 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_1 "\\leaders\\hbox{$\\cdot$}\\hfill "
+delim_2 "\\leaders\\hbox{$\\cdot$}\\hfill "
+
+lethead_flag 1
+lethead_prefix "\n\\centerline{\\bfseries --- "
+lethead_suffix  " ---}\\par\\nobreak"
+
+priority 0
+icu_rules "&a<<<A<\u00EB<<<\xCB<Ä<<<\x{00E4}<b<<B &ア<<<あ"
diff --git a/Master/texmf-dist/doc/upmendex/upmendex.doc b/Master/texmf-dist/doc/upmendex/upmendex.ja.txt
index c2f8b343a9f..14809d9bf50 100644
--- a/Master/texmf-dist/doc/upmendex/upmendex.doc
+++ b/Master/texmf-dist/doc/upmendex/upmendex.ja.txt
@@ -2,7 +2,8 @@ upmendex - 索引整形ツール
 
 使用法
 
-    upmendex [-ilqrcg] [-s sty] [-d dic] [-o ind] [-d dic] [-t log] [-p no] [--] [idx0 idx1 idx2 ...]
+    upmendex [-ilqrcgf] [-s sty] [-d dic] [-o ind] [-t log] [-p no] [--] [idx0 idx1 idx2 ...]
+    upmendex --help
 
 
 解説
@@ -55,6 +56,8 @@ upmendex - 索引整形ツール
            ジの次の奇数ページから)、even (最終ページの次の偶数ページから)といっ
            た指定も可能です。
 
+   --help  オプションの要約を表示します。
+
    --      以降はオプション文字列と解釈しません。
 
 
@@ -153,12 +156,12 @@ upmendex - 索引整形ツール
       ""
       lethead_suffixと同じ。
 
-   lethead_flag  <文字列>
+   lethead_flag  <数値>
       0
       頭文字の出力のフラグ。0のとき出力しない。1のときは英字を大文字で、
       -1のときは小文字で、2のときはタイトルケースで出力する。
 
-   heading_flag  <文字列>
+   heading_flag  <数値>
       0
       lethead_flagと同じ。
 
@@ -316,7 +319,7 @@ upmendex - 索引整形ツール
       ( Ref. http://userguide.icu-project.org/collation/customization
              http://www.unicode.org/reports/tr35/tr35-collation.html#Rules )
       UTF-8のUnicode文字及び、以下のエスケープ文字列が使用可能である:
-      \uhhhh (16進数[0-9A-Fa-f]を4桁), \Uhhhhhhhh (16進数を8桁),
+      \Uhhhhhhhh (16進数[0-9A-Fa-f]を8桁), \uhhhh (16進数を4桁),
       \xhh (16進数を2桁), \x{h...} (16進数を1〜8桁), \ooo (8進数[0-7]を3桁)。
       空文字列(デフォルト)のときは、localeによる照合順序のルールに従う。
       (upmendex専用)