Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
MIKTEX-MPOST(1) 		  User Commands 		 MIKTEX-MPOST(1)

NAME
     miktex-mpost - MetaPost, a system for creating graphics

SYNOPSIS
     miktex-mpost [option...] [[command...] | [file]]

DESCRIPTION
     This man page is an adaption of the corresponding TeX Live man page.

     MetaPost  interprets the MetaPost language and produces PostScript (EPS) or
     Scalable Vector Graphics (SVG) pictures. The MetaPost language  is  similar
     to Knuth's METAFONT with additional features for including TeX commands and
     accessing features of PostScript not found in METAFONT.

     MetaPost  is  normally used with some preloaded macros, and it will use its
     executable name as the name of the preload file to use. For  example,  when
     called  as  miktex-mpost  the  mpost.mp file is used, which is identical to
     plain.mp. When the --initialize option is given, preloading does  not  hap-
     pen.

     The  commands  given on the command line to the MetaPost program are passed
     to it as the first input line. (But it is often easier to type extended ar-
     guments as the first input line, since shells tend to gobble up  or  misin-
     terpret  MetaPost's  favorite  symbols,  like  semicolons, unless you quote
     them.) The normal usage is to say miktex-mpost figs  to  process  the  file
     figs.mp. The basename of figs becomes the "jobname", and is used in forming
     output  file names. If no file is named, the jobname becomes mpout. The de-
     fault extension, .mp, can be overridden by specifying an extension  explic-
     itly.

     When  the	--dvitomp option is given, MetaPost acts as DVI-to-MPX converter
     only. Run miktex-mpost --dvitomp --help for option explanation.

OPTIONS
     --alias=name
	 Pretend to be program name, i.e., set program (and memory dump) name to
	 name.	This may affect the search paths and other  values  used.  Using
	 this  option  is equivalent to copying the program file to name and in-
	 voking name.

     --c-style-errors
	 Change the way, error messages are printed. The alternate  style  looks
	 like error messages from many compilers and is easier to parse for some
	 editors.

     --debug
	 Print debugging info and leave temporary files in place.

     --halt-on-error
	 Quit after the first error.

     --help
	 Give help and exit.

     --initialize
	 Become the INI variant of the program.

     --interaction=mode
	 Set  the interaction mode. Must be one of batchmode, scrollmode and er-
	 rorstopmode. The meaning of these modes is the same as the  correspond-
	 ing commands.

     --job-name=name
	 Set  the  name of the job (\jobname).	This has an affect on the output
	 file names.

     --no-c-style-errors
	 Don't change the way, error messages are printed.

     --numbersystem=string
	 Set number system mode (string one of: scaled,  double,  binary,  deci-
	 mal).

     --output-directory=dir
	 Write	output	files in dir.  instead of the current directory. Look up
	 input files in dir first, then along the normal search path.

     --recorder
	 Enable the file name recorder. This leaves a trace of the files  opened
	 for input and output in a file with the extension .fls.

     --restricted
	 Be secure: disable tex, and editor commands.

     -s internal="string"
	 Set internal to the value.

     -s internal=number
	 Set internal to the value.

     --tex=texprogram
	 Use texprogram instead of miktex-tex when compiling text labels.

	 This flag overrides the environment variable TEX.

     --troff
	 Set prologues:=1 and assume --tex=troff.

     --undump=name
	 Use  name  as the name of the format to be used, instead of the name by
	 which the program was called or a

	     %&

	 line.

     --version
	 Show version information and exit.

ENVIRONMENT
     MIKTEX_TRACE
	 Comma-separated list  of  trace  stream  names  (see  Chapter 9,  Trace
	 Streams).  If	this  variable	is  set, then MiKTeX programs will write
	 trace messages into the configured log sink.

     MPINPUTS
	 Extra paths to locate MetaPostinput files.

     MPINPUTS
	 Extra paths to locate MetaPostinput files.

MiKTeX 25.4			 April 18, 2025 		 MIKTEX-MPOST(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=miktex-mpost&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help