From d1d0e717aae60c6822044e09400351961733c6c8 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 14 Apr 2016 16:56:24 +0000 Subject: ofm2opl,ovf2ovp: document all options on man pages git-svn-id: svn://tug.org/texlive/trunk@40514 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/web2c/man/ChangeLog | 7 +++ Build/source/texk/web2c/man/ofm2opl.man | 61 ++++++++++++++----------- Build/source/texk/web2c/man/ovf2ovp.man | 80 ++++++++++++++++++--------------- 3 files changed, 86 insertions(+), 62 deletions(-) (limited to 'Build/source/texk/web2c') 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 + + * 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 * 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 (mailing list)\&. You may also want to -check to see if the same bug is present in \fBpltotf\fP(1)\&. +Send bug reports to +(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 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: -.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 - and Yannis Haralambous -\&. +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 , 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 (mailing list)\&. You should also -check to see if the bug is also in \fBvftovp\fP(1)\&. +Send bug reports to +(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 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: -.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 - and Yannis Haralambous -\&. +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 , 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 -- cgit v1.2.3