diff options
author | Karl Berry <karl@freefriends.org> | 2018-03-30 22:27:37 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-03-30 22:27:37 +0000 |
commit | 455506ec711f0d6edd259c0b7c5e5a533d34ecee (patch) | |
tree | 6a4f46b633f148e55c3c025c05d8604d7fdea3aa /Master/texmf-dist/doc/man/man1/makejvf.1 | |
parent | 80cdd301189d43155d7e22400db1b0b72dd1bb02 (diff) |
doc updates
git-svn-id: svn://tug.org/texlive/trunk@47198 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/makejvf.1')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/makejvf.1 | 137 |
1 files changed, 134 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/man/man1/makejvf.1 b/Master/texmf-dist/doc/man/man1/makejvf.1 index bed1a5cdaea..b50785f8cc0 100644 --- a/Master/texmf-dist/doc/man/man1/makejvf.1 +++ b/Master/texmf-dist/doc/man/man1/makejvf.1 @@ -1,13 +1,117 @@ .if t .ds TX T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X .if t .ds LX L\\h'-0.36m'\\v'-0.15v'\\s-2A\\s+2\\h'-0.15m'\\v'0.15v'T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X -.TH MAKEJVF L +.TH MAKEJVF 1 .SH NAME makejvf \- Make Japanese VF file from Japanese \*(TX TFM file .SH SYNOPSIS -\fBmakejvf\fR [\fI<options>\fR] \fI<\*(TX TFM file>\fR \fI<TFM name of PS font>\fR +\fBmakejvf\fR [<\fIoptions\fR>] <\fI\*(TX TFM file\fR> <\fIPS font TFM\fR> .SH DESCRIPTION -\fBmakejvf\fP is a tool to generate Japanese VF file from Japanese \*(TX TFM +\fBmakejvf\fR is a tool to generate Japanese VF file from Japanese \*(TX TFM (JFM) file for use with dvips. +.TP 5 +When processing Japanese texts, p\*(TX refers to JFM (min10.tfm, jis.tfm \ +etc.), which includes definitions of some different character widths and \ +metric glue/kerns. For most punctuations and quotation marks, the \ +character widths are truncated to less than 1 zw (zenkaku-width; the \ +width of ordinary Kanji characters), and metric glue/kerns are inserted \ +as a substitute. +.TP 5 +On the other hand, in Japanese PS fonts, all punctuations and quotation \ +marks have the same character widths as ordinary Kanji characters. \ +For this reason, when dvips processes the resulting DVI, these characters \ +have to be shifted to the left by the amount of glue/kerns inserted. +.TP 5 +To achieve this, Virtual fonts (VF) and PS TFM files are required; \ +When VF contains the commands of shifting characters, PS font TFM can \ +have the exact character widths of PS fonts. +.TP 5 +The program \fBmakejvf\fR can be used for this purpose. \ +It inputs a p\*(TX JFM file (refered to as <\fI\*(TX TFM file\fR> in \ +\fBSYNOPSIS\fR above), and outputs a corresponding VF file \ +(with the same basename as <\fI\*(TX TFM file\fR>) and \ +a JFM file for a PS font JFM file (<\fIPS font TFM\fR> above). +.SH OPTIONS +.PP +.TP 10 +\fB-C\fR +Condensed ("Cho-tai") mode. +.TP 10 +\fB-K\fR <\fIPS-TFM\fR> +Map Kana (more exactly, non-Kanji) characters to another PS font JFM +named <\fIPS-TFM\fR>. +.TP 10 +\fB-b\fR <\fIinteger\fR> +Base line shift amount; the \fIinteger\fR represents a relative value, +using the character height as a base of 1000. +When a positive integer is specified, the characters are lowered. +When a negative integer is specified, the characters are raised. +.TP 10 +\fB-m\fR +Replace single/double quotation marks (', '') with single/double prime +quotation marks (so-called "minute") in vertical writing. +The replacement is realized by manipulating glyphs of prime and +double prime (JIS 0x216C and 0x216D; Unicode U+2032 and U+2033), +\fInot\fR by putting actual glyphs designed for quotation marks +(Unicode U+301D and U+301E/U+301F). +.TP 10 +\fB-a\fR <\fIAFMfile\fR> +Name of the input AFM file used for Kana-tsume mode. +This option is unsupported. +.TP 10 +\fB-k\fR <\fIinteger\fR> +Kana-tsume (narrower spaces between Kana characters) margin amount; +the \fIinteger\fR represents a relative value, using the character width +as a base of 1000. This option should be accompanied with \fB-a\fR option. +This option is unsupported. +.TP 10 +\fB-i\fR +Start mapped font ID from No. 0 in output VF +(by default, makejvf defaults to No. 1). +.TP 10 +\fB-e\fR +Enhanced mode; the horizontal shift amount is determined from the +glue/kern table of input JFM file. +.TP 10 +By default, \fBmakejvf\fR uses the hard-coded value as the horizontal \ +shift amount, which is (mostly) optimized for Japanese fonts. \ +When enhanced mode (option \fB-e\fR) is enabled, the shift amount is \ +determined from the input p\*(TX TFM (JFM) file, which is likely to \ +output most suitable VF for the JFM. +.TP 10 +For most standard Japanese JFM (like jis.tfm and its derivatives), \ +the output VFs from both modes will have no significant difference. \ +For simplified/traditional Chinese JFM (like upschrm-h.tfm and \ +uptchrm-h.tfm), the output VF from enhanced mode will be better. \ +For min10.tfm and its derivatives, enhanced mode should \fInever\fR be \ +enabled, since the characterization in min10.tfm is non-standard. +.TP 10 +\fB-t\fR <\fICNFfile\fR> +Use <\fICNFfile\fR> as a configuration file. +.TP 10 +\fB-u\fR <\fICharset\fR> +UCS mode. Available charsets are: gb (GB = Simplified Chinese), +cns (CNS = Traditional Chinese), ks (KS = Korean), +jis (JIS = Japanese), jisq (JIS quote only), +custom (user-defined CHARSET from <CNFfile>; +see \fBCONFIGURATION FILE FORMAT\fR section). +.TP 10 +Options below are effective only in UCS mode: +.TP 10 +\fB-J\fR <\fIPS-TFM\fR> +Map single/double quote to another JIS-encoded PSfont TFM. +.TP 10 +\fB-U\fR <\fIPS-TFM\fR> +Map single/double quote to another UCS-encoded PSfont TFM +.TP 10 +\fB-3\fR +Use set3, that is, enable non-BMP characters support (with UCS mode). +By default \fBmakejvf\fR does not output >=U+10000, to reduce file +size and to avoid problems with old DVI drivers. Recent versions of +dvipdfmx and others can handle VF with >=U+10000 (= set3 in DVI +language), therefore \fB-3\fR might be helpful. +.TP 10 +\fB-H\fR +Use half-width Katakana. .SH EXAMPLE .TP 5 If you want to use min10 as Ryumin-Light-H, run @@ -16,6 +120,32 @@ If you want to use min10 as Ryumin-Light-H, run This generates min10.vf and rml.tfm. Put these files in an appropriate \ directory under TEXMF tree, and add the following line to psfonts.map. rml Ryumin-Light-H +.SH CONFIGURATION FILE FORMAT +.TP 5 +With \fB-t\fR option, you can give \fBmakejvf\fR a custom settings \ +for generating VF. The syntax is: + + % comment line + MOVE <code> <right> <down> + + REPLACE <code> <new code> + CHARSET <code>,<code>,<code>..<code>,<code>, + + <code>,<code>..<code> + +.TP 5 +Each line should begin with a command, and should be TAB-separated. \ +Line starting with % is a comment, and empty lines are ignored. +.TP 5 +The \fBMOVE\fR command specifies horizontal/vertical shift amount \ +for the individual character <\fIcode\fR>. \ +The \fBREPLACE\fR command replaces the character <\fIcode\fR> with \ +<\fInew code\fR>. \ +The \fBCHARSET\fR command sets the custom character set of output VF; \ +the + character continues from the previous line. +.TP 5 +An example usage can be found in uptex-fonts project. \ +See GitHub repository + <https://github.com/texjporg/uptex-fonts>. .SH SEE ALSO More detailed description of \fBmakejvf\fR in Japanese is available at $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf @@ -23,5 +153,6 @@ More detailed description of \fBmakejvf\fR in Japanese is available at This manual page was written by Japanese \*(TX Development Community \ <https://texjp.org>. For more information, see GitHub repository \ <https://github.com/texjporg/ptex-fonts>. +.TP 5 Many thanks to Atsuhito KOHDA <kohda@debian.org>, \ for providing another manpage in Debian GNU/Linux system. |