summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/man/mpost.man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
committerKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
commitad547a6b5986815fda458221149728d9d9ab1d87 (patch)
tree16296910eb3eca724371474ea9aea3994dc69614 /Build/source/texk/web2c/man/mpost.man
parent947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff)
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/man/mpost.man')
-rw-r--r--Build/source/texk/web2c/man/mpost.man178
1 files changed, 178 insertions, 0 deletions
diff --git a/Build/source/texk/web2c/man/mpost.man b/Build/source/texk/web2c/man/mpost.man
new file mode 100644
index 00000000000..7eac5c0e016
--- /dev/null
+++ b/Build/source/texk/web2c/man/mpost.man
@@ -0,0 +1,178 @@
+.TH MPOST 1 "31 December 2018" "Web2C @VERSION@"
+.\"=====================================================================
+.de URL
+\\$2 \(laURL: \\$1 \(ra\\$3
+..
+.if \n[.g] .mso www.tmac
+.if n .ds MP MetaPost
+.if t .ds MP MetaPost
+.if n .ds MF Metafont
+.if t .ds MF Metafont
+.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
+.if n .ds WB Web
+.if t .ds WB W\s-2EB\s0
+.\"=====================================================================
+.SH NAME
+mpost, pmpost, upmpost \- MetaPost, a system for creating graphics
+r-mpost, r-pmpost, r-upmpost \- restricted MetaPost
+.SH SYNOPSIS
+.B mpost
+.RI [ options ]
+.RI [ commands ]
+.PP
+.B mpost
+.B --dvitomp
+.IR dvifile [\fB.dvi\fP]
+.RI [ mpxfile [\fB.mpx\fP]]
+
+.\"=====================================================================
+.SH DESCRIPTION
+\*(MP interprets the \*(MP language and produces PostScript (EPS)
+or Scalable Vector Graphics (SVG) pictures. The \*(MP language is similar
+to Knuth's \*(MF with additional features for including
+.BR tex (1)
+or
+.BR troff (1)
+commands and accessing features of PostScript not found in \*(MF.
+.PP
+\*(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 simply reads
+.IR plain.mp .
+When the
+.B --ini
+option is given, preloading does not happen.
+.PP
+The
+.I commands
+given on the command line to the \*(MP program are passed to it as the
+first input line. (But it is often easier to type extended arguments
+as the first input line, since UNIX shells tend to gobble up or
+misinterpret \*(MP's favorite symbols, like semicolons, unless you
+quote them.) The normal usage is to say
+.I mpost figs
+to process the file
+.IR figs.mp .
+The basename of
+.I figs
+becomes the ``jobname'',
+and is used in forming output file names. If no file is named, the
+jobname becomes
+.IR mpout .
+The default extension,
+.IR .mp ,
+can be overridden by specifying an extension explicitly.
+.PP
+When the
+.B --dvitomp
+option is given, \*(MP acts as DVI-to-MPX converter only.
+See dvitomp (1) for details.
+.PP
+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 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
+.I plain.mp
+The standard preload file.
+.TP
+.I mfplain.mp
+The \*(MF-compatible preload file.
+.TP
+.I $TEXMFMAIN/metapost/base/*.mp
+The standard \*(MP macros included in the original distribution.
+.TP
+.I $TEXMFMAIN/metapost/support/*
+Various tables for handling included
+.I tex
+and
+.IR troff .
+.TP
+.I $TEXMFMAIN/metapost/support/trfonts.map
+Table of corresponding font names for
+.I troff
+and PostScript.
+.TP
+.I psfonts.map
+Table of corresponding font names for
+.I tex
+and PostScript.
+.TP
+.I $TEXMFMAIN/doc/metapost/*
+The \*(MP manual and tutorial source, also including sample figures
+.\"=====================================================================
+.SH "SUGGESTED READING"
+Donald E. Knuth,
+.I "The \*(MF\^book"
+(Volume C of
+.IR "Computers and Typesetting" ),
+Addison-Wesley, 1986, ISBN 0-201-13445-4.
+.br
+.I TUGboat
+(the journal of the \*(TX Users Group).
+.\"=====================================================================
+.SH "SEE ALSO"
+.BR dvitomp (1),
+.BR epstopdf (1),
+.BR mf (1),
+.BR mptopdf (1),
+.BR tex (1),
+.br
+.URL "https://tug.org/metapost/" "MetaPost home page" .
+.\"=====================================================================
+.SH AUTHORS
+\*(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
+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 https://tug.org/metapost.