diff options
author | Karl Berry <karl@freefriends.org> | 2019-10-23 21:50:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-10-23 21:50:28 +0000 |
commit | eeab732aae7905ef02132ea5cd0571c63a420726 (patch) | |
tree | 43200fc28770a28ce5ac2125a9cfc4d398f9cab2 /Master/texmf-dist/doc/latex/bxjatoucs | |
parent | 09aef51981d5f356b77306646b3a48b74e8c3266 (diff) |
bxjatoucs (22oct19)
git-svn-id: svn://tug.org/texlive/trunk@52509 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bxjatoucs')
-rw-r--r-- | Master/texmf-dist/doc/latex/bxjatoucs/LICENSE | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bxjatoucs/README.md | 97 |
2 files changed, 118 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bxjatoucs/LICENSE b/Master/texmf-dist/doc/latex/bxjatoucs/LICENSE new file mode 100644 index 00000000000..534324b7566 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxjatoucs/LICENSE @@ -0,0 +1,21 @@ +The MIT License + +Copyright (c) 2019 Takayuki YATO (aka. "ZR") + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. diff --git a/Master/texmf-dist/doc/latex/bxjatoucs/README.md b/Master/texmf-dist/doc/latex/bxjatoucs/README.md new file mode 100644 index 00000000000..6e2c9bb7bc9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxjatoucs/README.md @@ -0,0 +1,97 @@ +BXjatoucs Package +================= + +LaTeX: To convert Japanese character code to Unicode + +This package provides function-like (fully-expandable) macros that +convert a character code value in several Japanese encodings to +a Unicode value. Supported source encodings are: ISO-2022-JP (jis), +EUC-JP (euc), Shift_JIS (sjis) and the Adobe-Japan1 glyph set. + +### System requirement + + * TeX format: LaTeX and plain TeX. + * TeX engine: Anything that has e-TeX extension. + * Dependent packages: + - infwarerr + - ltxcmds + +### Installation + + - `*.sty` → $TEXMF/tex/latex/bxjatoucs + - `*.tfm` → $TEXMF/fonts/tfm/public/bxjatoucs + +### License + +This package is distributed under the MIT License. + + +The bxjatoucs Package ― main +----------------------------- + +### Package Loading + +In plain TeX: + + \input bxjatoucs.sty + +In LaTeX: + + \usepackage{bxjatoucs} + +### Usage + +All the macros take an argument that forms a valid number and represents +the input code value, and expands (in two steps) to the string that +represents the output Unicode scalar value in decimal. + + - `\bxjaJisToUcs{<value>}`: converts from a jis scalar value. + - `\bxjaEucToUcs{<value>}`: converts from an euc scalar value. + - `\bxjaSjisToUcs{<value>}`: converts from a sjis scalar value. + - `\bxjaCidToUcs{<value>}`: converts from an AJ1 CID value. + +There are variants that return in hexadecimal (zero-padded to at least +four digits): + + - `\bxjaJisToUcsHex{<value>}` + - `\bxjaEucToUcsHex{<value>}` + - `\bxjaSjisToUcsHex{<value>}` + - `\bxjaCidToUcsHex{<value>}` + +Note: These macros return zero (decimal `0` and hexadecimal `0000`) +if the input number is out of the valid range of source encoding. +If the input is malformed, the macros issue an error `Missing number` +and then return zero. + +Additional variants: + + - `\bxjaFastCidToUcs{<value>}`: same as `bxjaCidToUcs`, except that + the argument is assumed to be a valid decimal string. + - `\bxjaFastCidToUcsHex{<value>}`: same for `\bxjaCidToUcsHex`. + +## Example + +The following `\message` lines all display `23551:21496`. + + \message{\bxjaJisToUcs{"3C77}:\bxjaJisToUcs{"3B4A}} + \message{\bxjaEucToUcs{"BCF7}:\bxjaEucToUcs{"BBCA}} + \message{\bxjaSjisToUcs{"8EF5}:\bxjaSjisToUcs{"8E69}} + \message{\bxjaCidToUcs{2339}:\bxjaCidToUcs{2200}} + +The following `\message` lines all display `5BFF:53F8`. + + \message{\bxjaJisToUcsHex{"3C77}:\bxjaJisToUcsHex{"3B4A}} + \message{\bxjaEucToUcsHex{"BCF7}:\bxjaEucToUcsHex{"BBCA}} + \message{\bxjaSjisToUcsHex{"8EF5}:\bxjaSjisToUcsHex{"8E69}} + \message{\bxjaCidToUcsHex{2339}:\bxjaCidToUcsHex{2200}} + + +Revision History +---------------- + + * Version 0.2 ‹2019/10/20› + - The first public version. + +-------------------- +Takayuki YATO (aka. "ZR") +https://github.com/zr-tex8r |