[u]p{pl,tf}to{tf,pl} man

git-svn-id: svn://tug.org/texlive/trunk@50664 c570f23f-e606-0410-a88d-b1316a301751

10 files changed, 198 insertions, 1 deletions

diff --git a/Master/texmf-dist/doc/man/man1/ppltotf.1 b/Master/texmf-dist/doc/man/man1/ppltotf.1
new file mode 100644
index 00000000000..22244ce1dc7
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/ppltotf.1
@@ -0,0 +1,96 @@
+.TH PPLTOTF 1 "15 March 2019" "Web2C 2019"
+.\"=====================================================================
+.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
+.if n .ds TX TeX
+.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\"
+.el .ds OX TeX\"
+.\" BX definition must follow TX so BX can use TX
+.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.if n .ds BX BibTeX
+.\" LX definition must follow TX so LX can use TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if n .ds LX LaTeX
+.\"=====================================================================
+.SH NAME
+ppltotf, uppltotf \- Create Japanese p\*(TX font metric (JFM)
+.SH SYNOPSIS
+.B ppltotf
+.RI [ options ]
+.IR pl_file_name [ \fB.pl\fP ]
+.RI [ tfm_file_name [ \fB.tfm\fP ]]
+.\"=====================================================================
+.SH DESCRIPTION
+The
+.B ppltotf
+program translates a Japanese property list (JPL) file to a Japanese
+p\*(TX font metric (JFM) file.
+The resulting JFM file can be used with p\*(TX and e-p\*(TX.
+.PP
+The
+.B uppltotf
+program is a Unicode-enabled version of ppltotf.
+The resulting JFM file can be used with up\*(TX and e-up\*(TX.
+.PP
+In the following sections, we refer to these programs as
+.BR (u)ppltotf .
+.PP
+.B (u)ppltotf
+is upper compatible with
+.BR pltotf ;
+if the input PL file is for roman fonts, it is translated into an
+ordinary \*(TX font metric (TFM) file.
+The difference between
+.B ppltotf
+and
+.B uppltotf
+lies in the output encoding:
+.B ppltotf
+always outputs JIS-encoded JFM; on the other hand,
+.B uppltotf
+outputs Unicode-encoded JFM by default.
+.\"=====================================================================
+.SH OPTIONS
+Compared to pltotf, the following option is added to
+.BR (u)ppltotf .
+.TP
+.BI -kanji \ string
+Sets the input Japanese \fIKanji\fR code.  The
+.I string
+can be one of the followings:
+.IR euc \ (EUC-JP),
+.IR jis \ (ISO-2022-JP),
+.IR sjis \ (Shift_JIS),
+.IR utf8 \ (UTF-8),
+.IR uptex \ (UTF-8;
+.B uppltotf
+only).
+.PP
+When one of
+.IR euc ,
+.IR jis ,
+.I sjis
+or
+.I utf8
+is specified, both
+.B ppltotf
+and
+.B uppltotf
+output a JIS-encoded JFM.
+When
+.I uptex
+is specified with
+.BR uppltotf ,
+it outputs a Unicode-encoded JFM.
+.\"=====================================================================
+.SH "SEE ALSO"
+.BR ptex (1).
+.\"=====================================================================
+.SH AUTHORS
+.B (u)ppltotf
+is maintained by
+Japanese \*(TX Development Community <https://texjp.org>.
+For bug reports, open an issue at
+GitHub repository <https://github.com/texjporg/tex-jp-build>,
+or send an e-mail to <issue@texjp.org>.
+.PP
+This manual page was written by Hironobu Yamashita.
diff --git a/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf b/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf
new file mode 100644
index 00000000000..b6c2c6dbdcc
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/ppltotf.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/ptftopl.1 b/Master/texmf-dist/doc/man/man1/ptftopl.1
new file mode 100644
index 00000000000..7595c35b1a3
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/ptftopl.1
@@ -0,0 +1,95 @@
+.TH PTFTOPL 1 "15 March 2019" "Web2C 2019"
+.\"=====================================================================
+.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
+.if n .ds TX TeX
+.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\"
+.el .ds OX TeX\"
+.\" BX definition must follow TX so BX can use TX
+.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.if n .ds BX BibTeX
+.\" LX definition must follow TX so LX can use TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if n .ds LX LaTeX
+.\"=====================================================================
+.SH NAME
+ptftopl, uptftopl \- Convert Japanese p\*(TX font metric (JFM) files to propery list
+.SH SYNOPSIS
+.B ptftopl
+.RI [ OPTIONS ]
+.IR tfm_name [ \fB.tfm\fP ]
+.RI [ pl_name [ \fB.pl\fP ]]
+.\"=====================================================================
+.SH DESCRIPTION
+The
+.B ptftopl
+program translates a Japanese p\*(TX font metric (JFM) file to a
+Japanese property list (JPL) file.  It also serves as a TFM/JFM-file
+validating program.
+.PP
+The
+.B uptftopl
+program is a Unicode-enabled version of ptftopl.
+.PP
+In the following sections, we refer to these programs as
+.BR (u)ptftopl .
+.PP
+.B (u)ptftopl
+is upper compatible with
+.BR tftopl ;
+if the input TFM file is for roman fonts, it is translated into an
+ordinary property list file.
+The difference between
+.B ptftopl
+and
+.B uptftopl
+lies in the internal encoding: when the input is a JFM file,
+.B ptftopl
+always treats it as a JIS-encoded JFM; on the other hand,
+.B uptftopl
+treats it as a Unicode-encoded JFM by default.
+.\"=====================================================================
+.SH OPTIONS
+Compared to tftopl, the following option is added to
+.BR (u)ptftopl .
+.TP
+.BI -kanji \ string
+Sets the output Japanese \fIKanji\fR code.  The
+.I string
+can be one of the followings:
+.IR euc \ (EUC-JP),
+.IR jis \ (ISO-2022-JP),
+.IR sjis \ (Shift_JIS),
+.IR utf8 \ (UTF-8),
+.IR uptex \ (UTF-8;
+.B uptftopl
+only).
+.PP
+When one of
+.IR euc ,
+.IR jis ,
+.I sjis
+or
+.I utf8
+is specified, both
+.B ptftopl
+and
+.B uptftopl
+treats the input JFM as JIS-encoded.
+When
+.I uptex
+is specified with
+.BR uptftopl ,
+it treats the input JFM as Unicode-encoded.
+.\"=====================================================================
+.SH "SEE ALSO"
+.BR ptex (1).
+.\"=====================================================================
+.SH AUTHORS
+.B (u)ptftopl
+is maintained by
+Japanese \*(TX Development Community <https://texjp.org>.
+For bug reports, open an issue at
+GitHub repository <https://github.com/texjporg/tex-jp-build>,
+or send an e-mail to <issue@texjp.org>.
+.PP
+This manual page was written by Hironobu Yamashita.
diff --git a/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf b/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf
new file mode 100644
index 00000000000..c0ad33d5501
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/ptftopl.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/uppltotf.1 b/Master/texmf-dist/doc/man/man1/uppltotf.1
new file mode 100644
index 00000000000..6d1e9f9fc73
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/uppltotf.1
@@ -0,0 +1 @@
+.so man1/ppltotf.1
diff --git a/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf b/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf
new file mode 100644
index 00000000000..85888986d28
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/uppltotf.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/uptftopl.1 b/Master/texmf-dist/doc/man/man1/uptftopl.1
new file mode 100644
index 00000000000..c03a38e1ad6
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/uptftopl.1
@@ -0,0 +1 @@
+.so man1/ptftopl.1
diff --git a/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf b/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf
new file mode 100644
index 00000000000..43e75539b48
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/uptftopl.man1.pdf
diff --git a/Master/tlpkg/tlpsrc/ptex.tlpsrc b/Master/tlpkg/tlpsrc/ptex.tlpsrc
index 743116e297d..b70343ea004 100644
--- a/Master/tlpkg/tlpsrc/ptex.tlpsrc
+++ b/Master/tlpkg/tlpsrc/ptex.tlpsrc
@@ -30,6 +30,8 @@ binpattern f/x86_64-cygwin bin/x86_64-cygwin/cygptexenc*.dll
 docpattern +f texmf-dist/doc/man/man1/eptex.*
 docpattern +f texmf-dist/doc/man/man1/makejvf.*
 docpattern +f texmf-dist/doc/man/man1/mendex.*
+docpattern +f texmf-dist/doc/man/man1/ppltotf.*
+docpattern +f texmf-dist/doc/man/man1/ptftopl.*
 docpattern +f texmf-dist/doc/man/man1/ptex.*
 
 # Runtime files in ptex-base.
diff --git a/Master/tlpkg/tlpsrc/uptex.tlpsrc b/Master/tlpkg/tlpsrc/uptex.tlpsrc
index e4887c03a06..5ce50e5c115 100644
--- a/Master/tlpkg/tlpsrc/uptex.tlpsrc
+++ b/Master/tlpkg/tlpsrc/uptex.tlpsrc
@@ -30,8 +30,10 @@ binpattern f bin/${ARCH}/wovp2ovf
 
 docpattern +f texmf-dist/doc/man/man1/euptex.*
 docpattern +f texmf-dist/doc/man/man1/upmendex.*
-docpattern +d texmf-dist/doc/upmendex
+docpattern +f texmf-dist/doc/man/man1/uppltotf.*
+docpattern +f texmf-dist/doc/man/man1/uptftopl.*
 docpattern +f texmf-dist/doc/man/man1/uptex.*
+docpattern +d texmf-dist/doc/upmendex
 
 # uptex-base excludes:
 runpattern +!d texmf-dist/tex/uptex/uptex-base