From 616554510f3c5def370ff9f2734796f304bdcbb0 Mon Sep 17 00:00:00 2001 From: Hironobu Yamashita Date: Fri, 23 Feb 2018 16:18:47 +0000 Subject: makejvf: improve help message and manual git-svn-id: svn://tug.org/texlive/trunk@46718 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/makejvf/ChangeLog | 1 + Build/source/texk/makejvf/main.c | 28 +++++++----- Build/source/texk/makejvf/makejvf.1 | 90 ++++++++++++++++++++----------------- 3 files changed, 68 insertions(+), 51 deletions(-) (limited to 'Build/source/texk/makejvf') diff --git a/Build/source/texk/makejvf/ChangeLog b/Build/source/texk/makejvf/ChangeLog index 0f1fda86b56..c9fd15c1807 100644 --- a/Build/source/texk/makejvf/ChangeLog +++ b/Build/source/texk/makejvf/ChangeLog @@ -1,5 +1,6 @@ 2018-02-23 Hironobu Yamashita + * main.c, makejvf.1: Improve help message and manual. * usrtable.c: Initialize CHARSET flag at other commands or an empty line. Make an error message more clear. * version.h: Bump version. diff --git a/Build/source/texk/makejvf/main.c b/Build/source/texk/makejvf/main.c index 14ff442aba4..86c0a0d6202 100644 --- a/Build/source/texk/makejvf/main.c +++ b/Build/source/texk/makejvf/main.c @@ -193,11 +193,15 @@ int main(int argc, char ** argv) void usage(void) { - fprintf(stderr, "MAKEJVF version %s -- make Japanese VF file.\n", VERSION); + fprintf(stderr, "MAKEJVF version %s -- make Japanese VF from a JFM file.\n", VERSION); + fputs2("Usage:\n", stderr); fputs2("%% makejvf [] \n", stderr); - fputs2("options:\n", stderr); + fputs2(" : Name of input pTeX/upTeX JFM file.\n", stderr); + fputs2(" The basename is inherited by the name of output VF file.\n", stderr); + fputs2(" : Name of output PSfont JFM file.\n", stderr); + fputs2("Options:\n", stderr); fputs2("-C 長体モード\n", stderr); - fputs2("-K 非漢字部用に作成するPSフォントTFM名\n", stderr); + fputs2("-K 非漢字部用に作成するPSフォントTFM名\n", stderr); fputs2("-b <数値> ベースライン補正\n", stderr); fputs2(" 文字の高さを1000として整数で指定\n", stderr); fputs2(" プラスで文字が下がり、マイナスで文字が上がる\n", stderr); @@ -205,16 +209,18 @@ void usage(void) fputs2("-a AFMファイル名(かな詰め時に使用)\n", stderr); fputs2("-k <数値> かな詰めマージン指定\n", stderr); fputs2(" 文字幅を1000として整数で指定。-aオプションと共に使用\n", stderr); + fputs2("-i Start mapped font ID from No. 0\n", stderr); + fputs2("-e Enhanced mode; the horizontal shift amount is determined\n", stderr); + fputs2(" from the glue/kern table of input\n", stderr); + fputs2("-t Use as a configuration file\n", stderr); fputs2("-u UCS mode\n", stderr); fputs2(" gb : GB, cns : CNS, ks : KS\n", stderr); fputs2(" jis : JIS, jisq : JIS quote only\n", stderr); - fputs2("-J JIS encoded PS font TFM name for quote, double quote (with UCS mode)\n", stderr); - fputs2("-U UCS encoded PS font TFM name for quote, double quote (with UCS mode)\n", stderr); - fputs2("-3 use set3 (with UCS mode)\n", stderr); - fputs2("-H use half-width katakana (with UCS mode)\n", stderr); - fputs2("-i font ID from No.0\n", stderr); - fputs2("-e enhanced mode; the horizontal shift amount is determined\n", stderr); - fputs2(" from the glue/kern table of input\n", stderr); - fputs2("-t use as a configuration file\n", stderr); + fputs2(" custom : Use user-defined CHARSET from \n", stderr); + fputs2("Options below are effective only in UCS mode:\n", stderr); + fputs2("-J Map single/double quote to another JIS-encoded PSfont TFM\n", stderr); + fputs2("-U Map single/double quote to another UCS-encoded PSfont TFM\n", stderr); + fputs2("-3 Use set3, that is, enable non-BMP characters support\n", stderr); + fputs2("-H Use half-width katakana\n", stderr); fprintf(stderr, "Email bug reports to %s.\n", BUG_ADDRESS); } diff --git a/Build/source/texk/makejvf/makejvf.1 b/Build/source/texk/makejvf/makejvf.1 index c7e09792251..b50785f8cc0 100644 --- a/Build/source/texk/makejvf/makejvf.1 +++ b/Build/source/texk/makejvf/makejvf.1 @@ -4,7 +4,7 @@ .SH NAME makejvf \- Make Japanese VF file from Japanese \*(TX TFM file .SH SYNOPSIS -\fBmakejvf\fR [\fI\fR] \fI<\*(TX TFM file>\fR \fI\fR +\fBmakejvf\fR [<\fIoptions\fR>] <\fI\*(TX TFM file\fR> <\fIPS font TFM\fR> .SH DESCRIPTION \fBmakejvf\fR is a tool to generate Japanese VF file from Japanese \*(TX TFM (JFM) file for use with dvips. @@ -22,19 +22,25 @@ 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; \ -VF should include the commands of shifting characters, and PS TFM should \ -have the exact character widths of PS fonts. \ -The program \fBmakejvf\fR can be used for this purpose. +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\fI \fR -Name of the PS font TFM for Kana (more exactly, non-Kanji) characters. +\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\fI \fR +\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. @@ -48,40 +54,19 @@ 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\fI \fR -Name of the AFM file. Used for Kana-tsume mode. +\fB-a\fR <\fIAFMfile\fR> +Name of the input AFM file used for Kana-tsume mode. This option is unsupported. .TP 10 -\fB-k\fI \fR +\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-u\fI \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 (see configuration file format section). -.TP 10 -\fB-J\fI \fR -JIS encoded PS font TFM name for quote, double quote (with UCS mode). -.TP 10 -\fB-U\fI \fR -UCS encoded PS font TFM name for quote, double quote (with UCS mode). -.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 (with UCS mode) -.TP 10 \fB-i\fR -Start font ID from No. 0. +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 @@ -100,8 +85,33 @@ 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\fI \fR -Use \fI\fR as a configuration file. +\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 ; +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 @@ -127,9 +137,9 @@ 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 \fI\fR. \ -The \fBREPLACE\fR command replaces the character \fI\fR with \ -\fI\fR. \ +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 @@ -141,8 +151,8 @@ More detailed description of \fBmakejvf\fR in Japanese is available at $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf .SH AUTHOR This manual page was written by Japanese \*(TX Development Community \ -. For more information, see GitHub repository - . +. For more information, see GitHub repository \ +. .TP 5 Many thanks to Atsuhito KOHDA , \ for providing another manpage in Debian GNU/Linux system. -- cgit v1.2.3