summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-04-14 16:56:24 +0000
committerKarl Berry <karl@freefriends.org>2016-04-14 16:56:24 +0000
commitd1d0e717aae60c6822044e09400351961733c6c8 (patch)
tree3637fe171db32d6b02fe75cd3de9e6850a0e2749
parentd515cd474914e8e84e64b8db0c2c9f56bdba041c (diff)
ofm2opl,ovf2ovp: document all options on man pages
git-svn-id: svn://tug.org/texlive/trunk@40514 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/texk/web2c/man/ChangeLog7
-rw-r--r--Build/source/texk/web2c/man/ofm2opl.man61
-rw-r--r--Build/source/texk/web2c/man/ovf2ovp.man80
3 files changed, 86 insertions, 62 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog
index 9a1ac090e2c..a47d1069485 100644
--- a/Build/source/texk/web2c/man/ChangeLog
+++ b/Build/source/texk/web2c/man/ChangeLog
@@ -1,3 +1,10 @@
+2016-04-14 Karl Berry <karl@freefriends.org>
+
+ * ofm2opl.man,
+ * ovf2ovp.man: document current options, i.e., from the omfonts
+ (../omegafonts) implementation. Akira re-implemented the web
+ -charcode-format option in r39877, ca.27 Feb 2016 10:23:20.
+
2016-03-08 Karl Berry <karl@tug.org>
* ttf2afm.man: document -m. tldoc mail from esr, 7 Mar 2016 09:34:07.
diff --git a/Build/source/texk/web2c/man/ofm2opl.man b/Build/source/texk/web2c/man/ofm2opl.man
index a374dead14c..c054bd456bf 100644
--- a/Build/source/texk/web2c/man/ofm2opl.man
+++ b/Build/source/texk/web2c/man/ofm2opl.man
@@ -1,4 +1,4 @@
-.TH OFM2OPL "16 June 2015" "Web2C @VERSION@"
+.TH OFM2OPL "14 April 2016" "Web2C @VERSION@"
.PP
.SH "NAME"
ofm2opl \- convert Omega and TeX font-metric files to property-list files
@@ -6,33 +6,39 @@ ofm2opl \- convert Omega and TeX font-metric files to property-list files
.SH "SYNOPSIS"
.PP
.B ofm2opl
-.RI [ OPTIONS ]
-.IR OFMNAME [ \fB.ofm\fP ]
-.RI [ OPLFILE [ \fB.opl\fP ]]
+.RI [ options ]
+.IR ofmname [ \fB.ofm\fP ]
+.RI [ oplfile [ \fB.opl\fP ]]
.PP
.SH "DESCRIPTION"
.PP
\fBofm2opl\fP translates a binary Omega Font Metrics file,
-\fIOFMNAME\fP, into a human-readable property-list form\&. The
+\fIofmname\fP, into a human-readable property-list form\&. The
program writes to standard output (by default) or to a file specified
-as \fIOPLFILE\fP\&.
+as \fIoplfile\fP\&.
.PP
The program also works with TeX TFM files, producing TeX PL files\&.
-(\fBofm2opl\fP is based on the WEB source code for \fBtftopl\fP(1)\&.)
.PP
.SH "OPTIONS"
.PP
+(Same as \fBovf2ovp\fP).
.IP
-.IP "\fB-charcode-format=\fP\fITYPE\fP"
-output character codes
-according to \fITYPE\fP,
-which can be either `hex\&'
-or `ascii\&'\&. Default is
-`hex\&'\&. ascii specifes all
-ASCII letters and digits;
-hex gets you everything
-else\&.
-.IP
+.IP "\fB-charcode-format=\fP\fItype\fP"
+output character codes according to \fItype\fP,
+either `hex\&', `octal\&' or `ascii\&'\&. Default is
+`hex\&'\&; `ascii' says to use
+ASCII for letters and digits, hex for all else\&.
+.IP "\fB-char-format=\fP\fIstype\fP"
+output character codes according to \fIstype\fP,
+either `num\&' or `ascii\&'\&. Default is `num'; `ascii' as in
+-charcode-format. (These two redundant options both exist only for
+historical compatibility.)
+.IP "\fB-num-format=\fP\fIntype\fP"
+output numbers according to \fIntype\fP,
+either `hex' or `octal'; default is hex.
+.IP "\fB-text-format=\fP\fIttype\fP"
+output coding scheme and family according to \fIttype\fP,
+either `mixed' or `upper' case; default is mixed.
.IP "\fB-help\fP"
display a brief summary of syntax and options
.IP "\fB-verbose\fP"
@@ -50,18 +56,16 @@ an Omega Property List file
.PP
.SH "BUGS"
.PP
-None known, but report any found to <omega@ens\&.fr> (mailing list)\&. You may also want to
-check to see if the same bug is present in \fBpltotf\fP(1)\&.
+Send bug reports to <http://lists.tug.org/tex-k>
+(mailing list); may also check if the same bug is present in
+\fBtftopl\fP(1)\&. General discussion of Omega (and Aleph) can take place
+on the <http://lists.tug.org/omega> mailing list.
.PP
.SH "SEE ALSO"
.PP
-\fBomega\fP(1), \fBopl2ofm\fP(1), \fBpltotf\fP(1),
+\fBomega\fP(1), \fBaleph\fP(1), \fBopl2ofm\fP(1), \fBpltotf\fP(1),
\fBtftopl\fP(1)\&.
.PP
-\fIDraft Manual for the Omega System\fP (\fIomega-manual\&.dvi\fP)\&.
-.PP
-Web page: <http://www\&.gutenberg\&.eu\&.org/omega/>
-.PP
.SH "AUTHOR"
.PP
According to the WEB documentation:
@@ -79,10 +83,13 @@ Extensions to handle extended font metric files (``OFM\&'\&') were added
by John Plaice in December 1995 and January 1996, resulting in the new
program \fBOFM2OPL\fP\&.
.RE
+.PP
+\fBofm2opl\fP is based on the WEB source code for \fBtftopl\fP(1),
+although nowadays it is a link to \fBomfonts\fP, implemented entirely in
+C.
.PP
-The primary authors of Omega are John Plaice
-<plaice@cse\&.unsw\&.edu\&.au> and Yannis Haralambous
-<yannis@fluxus-virus\&.com>\&.
+The primary authors of Omega are John Plaice and Yannis Haralambous.
+Omega (and Aleph) are now maintained as part of TeX Live.
.PP
This manual page was written by C\&.M\&. Connelly
<cmc@debian\&.org>, for
diff --git a/Build/source/texk/web2c/man/ovf2ovp.man b/Build/source/texk/web2c/man/ovf2ovp.man
index fa3c250b7e3..467ecc3876d 100644
--- a/Build/source/texk/web2c/man/ovf2ovp.man
+++ b/Build/source/texk/web2c/man/ovf2ovp.man
@@ -1,36 +1,46 @@
-.TH OVF2OVP "16 June 2015" "Web2C @VERSION@"
+.TH OVF2OVP "14 April 2016" "Web2C @VERSION@"
.PP
.SH "NAME"
-ovf2ovp \- convert a virtual font file and its associated font metric file into property-list format
+ovf2ovp \- convert virtual font file and associated font metrics to property-list format
.PP
.SH "SYNOPSIS"
.PP
.B ovf2ovp
-.RI [ OPTIONS ]
-.IR OVFNAME [ \fB.ovf\fP ]
-.RI [ OFMNAME [ \fB.ofm\fP ]
-.RI [ OVPFILE [ \fB.ovp\fP ]]]
+.RI [ options ]
+.IR ovfname [ \fB.ovf\fP ]
+.RI [ ofmname [ \fB.ofm\fP ]
+.RI [ ovpfile [ \fB.ovp\fP ]]]
.PP
.SH "DESCRIPTION"
.PP
-\fBovf2ovp\fP translates a virtual font (OVF) file, \fIOVFNAME\fP,
-and its companion font metric (OFM) file, \fIOFMNAME\fP, into a
+\fBovf2ovp\fP translates a virtual font (OVF) file, \fIovfname\fP,
+and its companion font metric (OFM) file, \fIofmname\fP, into a
human-readable property-list format\&. The program writes to standard
-output (by default) or to a file specified as \fIOVPNAME\fP\&.
+output (by default) or to a file specified as \fIovpname\fP\&.
.PP
-The program also works with TeX VF and TFM files, producing TeX VP
-files\&. (\fBovf2ovp\fP is based on the WEB source code for
-\fBvftovp\fP(1)\&.)
+The program also works with TeX VF and TFM files, producing TeX VPL
+files\&.
.PP
.SH "OPTIONS"
-.PP
-.IP
-.IP "\fB-charcode-format=\fP\fITYPE\fP"
-output character codes
-according to \fITYPE\fP, which can be either `hex\&' or `ascii\&'\&.
-Default is `hex\&'\&. ascii specifes all ASCII letters and digits; hex
-gets you everything else\&.
-.IP
+.PP
+(Same as \fBofm2opl\fP).
+.IP
+.IP "\fB-charcode-format=\fP\fItype\fP"
+output character codes according to \fItype\fP,
+either `hex\&', `octal\&' or `ascii\&'\&. Default is
+`hex\&'\&; `ascii' says to use
+ASCII for letters and digits, hex for all else\&.
+.IP "\fB-char-format=\fP\fIstype\fP"
+output character codes according to \fIstype\fP,
+either `num\&' or `ascii\&'\&. Default is `num'; `ascii' as in
+-charcode-format. (These two redundant options both exist only for
+historical compatibility.)
+.IP "\fB-num-format=\fP\fIntype\fP"
+output numbers according to \fIntype\fP,
+either `hex' or `octal'; default is hex.
+.IP "\fB-text-format=\fP\fIttype\fP"
+output coding scheme and family according to \fIttype\fP,
+either `mixed' or `upper' case; default is mixed.
.IP "\fB-help\fP"
display a brief summary of syntax and options
.IP "\fB-verbose\fP"
@@ -41,44 +51,45 @@ output version information and exit
.PP
.SH "FILES"
.PP
-.IP "\fIOVPFILE\fP"
+.IP "\fIovpfile\fP"
Omega Virtual Property List file
-.IP "\fIOFMNAME\fP"
+.IP "\fIofmname\fP"
Omega Font Metric file
-.IP "\fIOVFNAME\fP"
+.IP "\fIovfname\fP"
Omega Virtual Font file
.PP
.SH "BUGS"
.PP
-None known, but report any found to <omega@ens\&.fr> (mailing list)\&. You should also
-check to see if the bug is also in \fBvftovp\fP(1)\&.
+Send bug reports to <http://lists.tug.org/tex-k>
+(mailing list); may also check if the same bug is present in
+\fBvftovp\fP(1)\&. General discussion of Omega (and Aleph) can take place
+on the <http://lists.tug.org/omega> mailing list.
.PP
.SH "SEE ALSO"
.PP
-\fBomega\fP(1), \fBofm2opl\fP(1), \fBovp2ovf\fP(1),
+\fBomega\fP(1), \fBaleph\fP(1), \fBofm2opl\fP(1), \fBovp2ovf\fP(1),
\fBpltotf\fP(1), \fBtftopl\fP(1), \fBvftovp\fP(1),
\fBvptovf\fP(1)
.PP
-\fIDraft Manual for the Omega System\fP (\fIomega-manual\&.dvi\fP)\&.
-.PP
-Web page: <http://www\&.gutenberg\&.eu\&.org/omega/>
-.PP
.SH "AUTHOR"
.PP
According to the WEB documentation:
.PP
.RS
\fBVFtoVP\fP is an extended version of the program \fBTFtoPL\fP,
-which is part of the standard tex()ware library\&. The idea of a
+which is part of the standard TeXware library\&. The idea of a
virtual font was inspired by the work of David R\&. Fuchs who designed a
similar set of conventions in 1984 while developing a device driver
for ArborText, Inc\&. He wrote a somewhat similar program called
\fBAMFtoXPL\fP\&.
.RE
+.PP
+Thus, \fBovf2ovp\fP is based on the WEB source code for \fBvftovp\fP(1),
+although nowadays it is a link to \fBomfonts\fP, implemented entirely in
+C.
.PP
-The primary authors of Omega are John Plaice
-<plaice@cse\&.unsw\&.edu\&.au> and Yannis Haralambous
-<yannis@fluxus-virus\&.com>\&.
+The primary authors of Omega are John Plaice and Yannis Haralambous.
+Omega (and Aleph) are now maintained as part of TeX Live.
.PP
This manual page was written by C\&.M\&. Connelly
<cmc@debian\&.org>, for
@@ -86,4 +97,3 @@ the Debian GNU/Linux system\&. It may be used by other distributions
without contacting the author\&. Any mistakes or omissions in the
manual page are my fault; inquiries about or corrections to this
manual page should be directed to me (and not to the primary author)\&.
-.PP