summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/mpost.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-02-28 19:09:21 +0000
committerKarl Berry <karl@freefriends.org>2019-02-28 19:09:21 +0000
commit342f4c70c13251fa670faa123091c128ec8bfdda (patch)
tree1738b687cc48d0cdb5551aee4e90bb291403c3b4 /Master/texmf-dist/doc/man/man1/mpost.1
parent3a9439b815af6c2d41c60f6694d88f2852544442 (diff)
tl19 man page update
git-svn-id: svn://tug.org/texlive/trunk@50169 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/mpost.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/mpost.155
1 files changed, 34 insertions, 21 deletions
diff --git a/Master/texmf-dist/doc/man/man1/mpost.1 b/Master/texmf-dist/doc/man/man1/mpost.1
index 7f064a0df86..86485966f0e 100644
--- a/Master/texmf-dist/doc/man/man1/mpost.1
+++ b/Master/texmf-dist/doc/man/man1/mpost.1
@@ -1,4 +1,4 @@
-.TH MPOST 1 "16 June 2015" "Web2C 2018"
+.TH MPOST 1 "31 December 2018" "Web2C 2019"
.\"=====================================================================
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
@@ -22,7 +22,8 @@
.if t .ds WB W\s-2EB\s0
.\"=====================================================================
.SH NAME
-mpost \- MetaPost, a system for creating graphics
+mpost, pmpost, upmpost \- MetaPost, a system for creating graphics
+r-mpost, r-pmpost, r-upmpost \- restricted MetaPost
.SH SYNOPSIS
.B mpost
.RI [ options ]
@@ -43,14 +44,14 @@ or
.BR troff (1)
commands and accessing features of PostScript not found in \*(MF.
.PP
-\*(MP is normally used with some preloaded macros, and it
+\*(MP is normally used with a set of basic macros, and it
will use its executable name as the name of the preload
file to use. For example, when called as
.B mpost
the
.I mpost.mp
-file is used, which is identical to
-.I plain.mp.
+file is used, which simply reads
+.IR plain.mp .
When the
.B --ini
option is given, preloading does not happen.
@@ -80,16 +81,32 @@ When the
option is given, \*(MP acts as DVI-to-MPX converter only.
See dvitomp (1) for details.
.PP
-This manual page is not meant to be exhaustive. The complete
-documentation for this version of \*(MP can be found in the
+The
+.B pmpost
+program is a variant with Japanese support, and
+.B upmpost
+has Unicode-enabled Japanese support, analogous to ptex and uptex.
+.PP
+All three variants are also installed with an `r-' prefix, that is,
+.BR r-mpost ,
+.BR r-pmpost ,
+.BR r-upmpost ,
+which implicitly specify the
+.B --restricted
+option to make MetaPost safe to run on unknown input; the tex, makempx,
+and editor commands are disabled.
+.PP
+This manual page is a mere skeleton. For a list of all command line
+options, run
+.BR --help .
+.PP
+The main documentation for this version of \*(MP can be found in the
User Manual that should have been installed along with the program and
-is also available from http://tug.org/metapost.
-See the FILES section below.
+is also available from https://tug.org/metapost.
.PP
The \*(MP language is similar to \*(MF, but the manual
assumes no knowledge of \*(MF. \*(MP does not have bitmap
output commands or \*(MF's online display mechanism.
-
.\"=====================================================================
.SH FILES
.TP
@@ -132,34 +149,30 @@ Addison-Wesley, 1986, ISBN 0-201-13445-4.
(the journal of the \*(TX Users Group).
.\"=====================================================================
.SH "SEE ALSO"
-.PP
.BR dvitomp (1),
.BR epstopdf (1),
.BR mf (1),
.BR mptopdf (1),
.BR tex (1),
-.PP
-.URL "http://foundry.supelec.fr/gf/project/metapost/" "MetaPost source code" .
.br
-.URL "http://tug.org/metapost/" "MetaPost home page" .
+.URL "https://tug.org/metapost/" "MetaPost home page" .
.\"=====================================================================
.SH AUTHORS
-\*(MP was designed by John D. Hobby, incorporating algorithms from
+\*(MP was created by John D. Hobby, incorporating algorithms from
\*(MF by Donald E. Knuth. It was originally implemented on Unix,
incorporating system-dependent routines from
.BR web2c ,
while not relying on it except for the actual \*(WB-to-C translator.
.PP
-The primary author of the current \*(MP was Taco Hoekwater, with
-assistance from Hans Hagen and many others. It is currently maintained
-by Luigi Scarso.
-.PP
Ulrik Vieth adapted \*(MP to take advantage of the advanced path
searching features in more recent versions of
.B web2c
and worked towards fully integrating \*(MP into the canonical Unix
\*(TX distribution.
+.PP
+The primary author of the current \*(MP was Taco Hoekwater, with
+assistance from Hans Hagen and many others. It is currently maintained
+by Luigi Scarso.
.\"=====================================================================
.SH BUGS
-The MetaPost home page is http://tug.org/metapost.
-
+The MetaPost home page is https://tug.org/metapost.