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)