texlive[46718] Build/source/texk/makejvf: makejvf: improve help
commits+hironobu at tug.org
commits+hironobu at tug.org
Fri Feb 23 17:18:48 CET 2018
Revision: 46718
http://tug.org/svn/texlive?view=revision&revision=46718
Author: hironobu
Date: 2018-02-23 17:18:47 +0100 (Fri, 23 Feb 2018)
Log Message:
-----------
makejvf: improve help message and manual
Modified Paths:
--------------
trunk/Build/source/texk/makejvf/ChangeLog
trunk/Build/source/texk/makejvf/main.c
trunk/Build/source/texk/makejvf/makejvf.1
Modified: trunk/Build/source/texk/makejvf/ChangeLog
===================================================================
--- trunk/Build/source/texk/makejvf/ChangeLog 2018-02-23 14:38:56 UTC (rev 46717)
+++ trunk/Build/source/texk/makejvf/ChangeLog 2018-02-23 16:18:47 UTC (rev 46718)
@@ -1,5 +1,6 @@
2018-02-23 Hironobu Yamashita <h.y.acetaminophen at gmail.com>
+ * 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.
Modified: trunk/Build/source/texk/makejvf/main.c
===================================================================
--- trunk/Build/source/texk/makejvf/main.c 2018-02-23 14:38:56 UTC (rev 46717)
+++ trunk/Build/source/texk/makejvf/main.c 2018-02-23 16:18:47 UTC (rev 46718)
@@ -193,11 +193,15 @@
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 [<options>] <TFMfile> <PSfontTFM>\n", stderr);
- fputs2("options:\n", stderr);
+ fputs2(" <TFMfile>: Name of input pTeX/upTeX JFM file.\n", stderr);
+ fputs2(" The basename is inherited by the name of output VF file.\n", stderr);
+ fputs2(" <PSfontTFM>: Name of output PSfont JFM file.\n", stderr);
+ fputs2("Options:\n", stderr);
fputs2("-C Ĺ\xC2Υ⡼\xA5\xC9\n", stderr);
- fputs2("-K <TFMfile> \xC8\xF3\xB4\xC1\xBB\xFA\xC9\xF4\xCDѤ˺\xEE\xC0\xAE\xA4\xB9\xA4\xEBPS\xA5ե\xA9\xA5\xF3\xA5\xC8TFM̾\n", stderr);
+ fputs2("-K <PS-TFM> \xC8\xF3\xB4\xC1\xBB\xFA\xC9\xF4\xCDѤ˺\xEE\xC0\xAE\xA4\xB9\xA4\xEBPS\xA5ե\xA9\xA5\xF3\xA5\xC8TFM̾\n", stderr);
fputs2("-b <\xBF\xF4\xC3\xCD> \xA5١\xBC\xA5\xB9\xA5饤\xA5\xF3\xCA\xE4\xC0\xB5\n", stderr);
fputs2(" ʸ\xBB\xFA\xA4ι⤵\xA4\xF21000\xA4Ȥ\xB7\xA4\xC6\xC0\xB0\xBF\xF4\xA4ǻ\xD8\xC4\xEA\n", stderr);
fputs2(" \xA5ץ饹\xA4\xC7ʸ\xBB\xFA\xA4\xAC\xB2\xBC\xA4\xAC\xA4ꡢ\xA5ޥ\xA4\xA5ʥ\xB9\xA4\xC7ʸ\xBB\xFA\xA4\xAC\xBE夬\xA4\xEB\n", stderr);
@@ -205,16 +209,18 @@
fputs2("-a <AFMfile> AFM\xA5ե\xA1\xA5\xA4\xA5\xEB̾\xA1ʤ\xAB\xA4ʵͤ\xE1\xBB\xFE\xA4˻\xC8\xCDѡ\xCB\n", stderr);
fputs2("-k <\xBF\xF4\xC3\xCD> \xA4\xAB\xA4ʵͤ\xE1\xA5ޡ\xBC\xA5\xB8\xA5\xF3\xBB\xD8\xC4\xEA\n", stderr);
fputs2(" ʸ\xBB\xFA\xC9\xFD\xA4\xF21000\xA4Ȥ\xB7\xA4\xC6\xC0\xB0\xBF\xF4\xA4ǻ\xD8\xC4ꡣ-a\xA5\xAA\xA5ץ\xB7\xA5\xE7\xA5\xF3\xA4ȶ\xA6\xA4˻\xC8\xCD\xD1\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 <TFMfile> input\n", stderr);
+ fputs2("-t <CNFfile> Use <CNFfile> as a configuration file\n", stderr);
fputs2("-u <Charset> UCS mode\n", stderr);
fputs2(" <Charset> gb : GB, cns : CNS, ks : KS\n", stderr);
fputs2(" jis : JIS, jisq : JIS quote only\n", stderr);
- fputs2("-J <TFMfile> JIS encoded PS font TFM name for quote, double quote (with UCS mode)\n", stderr);
- fputs2("-U <TFMfile> 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 <TFMfile> input\n", stderr);
- fputs2("-t <CNFfile> use <CNFfile> as a configuration file\n", stderr);
+ fputs2(" custom : Use user-defined CHARSET from <CNFfile>\n", stderr);
+ fputs2("Options below are effective only in UCS mode:\n", stderr);
+ fputs2("-J <PS-TFM> Map single/double quote to another JIS-encoded PSfont TFM\n", stderr);
+ fputs2("-U <PS-TFM> 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);
}
Modified: trunk/Build/source/texk/makejvf/makejvf.1
===================================================================
--- trunk/Build/source/texk/makejvf/makejvf.1 2018-02-23 14:38:56 UTC (rev 46717)
+++ trunk/Build/source/texk/makejvf/makejvf.1 2018-02-23 16:18:47 UTC (rev 46718)
@@ -4,7 +4,7 @@
.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\fR is a tool to generate Japanese VF file from Japanese \*(TX TFM
(JFM) file for use with dvips.
@@ -22,9 +22,14 @@
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
@@ -31,10 +36,11 @@
\fB-C\fR
Condensed ("Cho-tai") mode.
.TP 10
-\fB-K\fI <TFMfile>\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 <integer>\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 @@
\fInot\fR by putting actual glyphs designed for quotation marks
(Unicode U+301D and U+301E/U+301F).
.TP 10
-\fB-a\fI <AFMfile>\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 <integer>\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 <Charset>\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 <TFMfile>\fR
-JIS encoded PS font TFM name for quote, double quote (with UCS mode).
-.TP 10
-\fB-U\fI <TFMfile>\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 @@
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 <CNFfile>\fR
-Use \fI<CNFfile>\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 <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
@@ -127,9 +137,9 @@
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<code>\fR. \
-The \fBREPLACE\fR command replaces the character \fI<code>\fR with \
-\fI<new code>\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 @@
$TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf
.SH AUTHOR
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>.
+<https://texjp.org>. For more information, see GitHub repository \
+<https://github.com/texjporg/ptex-fonts>.
.TP 5
Many thanks to Atsuhito KOHDA <kohda at debian.org>, \
for providing another manpage in Debian GNU/Linux system.
More information about the tex-live-commits
mailing list