NAME

       makejvf - Make Japanese VF file from Japanese TeX TFM file

SYNOPSIS

       makejvf [<options>] <TeX TFM file> <PS font TFM>

DESCRIPTION

       makejvf is a tool to generate Japanese VF file from Japanese TeX TFM (JFM) file for use with dvips.

       When processing Japanese texts, pTeX 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.

       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.

       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.

       The program makejvf can be used for this purpose. It inputs a pTeX JFM file (referred to as <TeX TFM
       file> in SYNOPSIS above), and outputs a corresponding VF file (with the same basename as <TeX TFM file>)
       and a JFM file for a PS font JFM file (<PS font TFM> above).

OPTIONS

       -C        Condensed ("Cho-tai") mode.

       -K <PS-TFM>
                 Map Kana (more exactly, non-Kanji) characters to another PS font JFM named <PS-TFM>.

       -b <integer>
                 Base  line shift amount; the integer 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.

       -m        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), not by putting
                 actual glyphs designed for quotation marks (Unicode U+301D and U+301E/U+301F).

       -a <AFMfile>
                 Name of the input AFM file used for Kana-tsume mode.  This option is unsupported.

       -k <integer>
                 Kana-tsume (narrower spaces between Kana characters) margin amount; the  integer  represents  a
                 relative  value, using the character width as a base of 1000. This option should be accompanied
                 with -a option.  This option is unsupported.

       -i        Start mapped font ID from No. 0 in output VF (by default, makejvf defaults to No. 1).

       -e        Enhanced mode; the horizontal shift amount is determined from the glue/kern table of input  JFM
                 file.

       By default, makejvf uses the hard-coded value as the horizontal shift amount, which is (mostly) optimized
       for Japanese fonts. When enhanced mode (option -e) is enabled, the shift amount is determined from the
       input pTeX TFM (JFM) file, which is likely to output most suitable VF for the JFM.

       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 never be enabled, since the characterization in min10.tfm is non-standard.

       -t <CNFfile>
                 Use <CNFfile> as a configuration file.

       -O        Omit  entries  in  VF for characters with default metric. This option is not allowed to be used
                 with the option -t.

       -u <Charset>
                 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 CONFIGURATION FILE FORMAT section).

       Options below are effective only in UCS mode:

       -J <PS-TFM>
                 Map single/double quote to another JIS-encoded PSfont TFM.

       -U <PS-TFM>
                 Map single/double quote to another UCS-encoded PSfont TFM.

       -3        Use set3, that is, enable non-BMP characters support (with UCS mode).  By default makejvf  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 -3 might be helpful.

       -H        Use half-width Katakana.

EXAMPLE

       If you want to use min10 as Ryumin-Light-H, run
                 makejvf min10.tfm rml

       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

CONFIGURATION FILE FORMAT

       With -t option, you can give makejvf 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>

       Each line should begin with a command, and should be TAB-separated. Line starting with % is a comment,
       and empty lines are ignored.

       The MOVE command specifies horizontal/vertical shift amount for the individual character <code>. The
       REPLACE command replaces the character <code> with <new code>. The CHARSET command sets the custom
       character set of output VF; the + character continues from the previous line.

       An example usage can be found in uptex-fonts project. See GitHub repository
                 <https://github.com/texjporg/uptex-fonts>.

SEE ALSO

       More detailed description of makejvf in Japanese is available at
            $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf

AUTHOR

       This  manual  page  was  written  by  Japanese  TeX  Development  Community <https://texjp.org>. For more
       information, see GitHub repository <https://github.com/texjporg/ptex-fonts>.

       Many thanks to Atsuhito KOHDA <kohda@debian.org>, for providing another manpage in Debian GNU/Linux
       system.

                                                                                                      MAKEJVF(1)