.\"                                      Hey, EMACS: -*- nroff -*-
.TH MLPOST 1 "August 2009"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
mlpost \- wrapper around OCaml and Metapost for the Mlpost library
.SH SYNOPSIS
.B mlpost
.RI [options] " files"...
.SH DESCRIPTION
.PP
\fBmlpost\fP is a program that compiles OCaml files to PostScript or PDF files using the Mlpost library.
.SH OPTIONS
.TP
.B \-pdf
Generate .mps files (default)
.TP
.B \-mp
Generate .mp files
.TP
.B \-png
Generate .png files
.TP
.B \-ps
Generate .1 files
.TP
.B \-latex <main.tex>
Scan the LaTeX prelude
.TP
.B \-eps
Generate encapsulated postscript files
.TP
.B \-xpdf
WYSIWYG mode using xpdf remote server (the name of the remote server
is "mlpost")
.TP
.B \-v
Be a bit more verbose. Otherwise nothing is printed except in case of error.
.TP
.B \-ocamlbuild
Use ocamlbuild to compile
.TP
.B \-native
Compile to native code
.TP
.B \-ccopt "<options>"
Pass <options> to the Ocaml compiler
.TP
.B \-execopt "<options>"
Pass <options> to the compiled program
.TP
.B \-version
Print Mlpost version and exit
.TP
.B \-no\-magic
Do not parse mlpost options, do not call Metapost.dump
.TP
.B \-depend
output dependency lines in a format suitable for the make(1) utility
.TP
.B \-contrib "<contrib-name>"
compile with the specified contrib
.TP
.B \-dumpable
output one name of dumpable file by line. So it print all the figures
which will be created by the .ml file.
.TP
.B \-get\-include\-compile {cmxa|cma|dir|file}
output the libraries which are needed by the library Mlpost if you want not to use the mlpost tool :
.IP
        \- cmxa print the needed cmxa file (opt version)
        \- cma print the needed cma file (byte version)
        \- dir print the directories needed to be include
        \- file print the file name inside this directory without
extension

.TP
.B \-compile\-name <compile-name>
Keep the compiled version of the .ml file and name it <compile-name>.
.TP
.B \-dont\-execute
Don't execute the mlfile. So mlpost generates no figures. With this
option you can check that a file compile without wasting time to
generate the figures. The options \-dont\-execute and \-compile\-name
can be used in conjunction to
create a program which generates some figures according to some command
line options.
.TP
.B \-dont\-clean
Don't remove intermediates files. The metapost backend use some
intermediates files which are removed without this option.
.TP
.B \-cairo
Use the cairo backend instead of metapost
.TP
.B \-t1disasm
Set the program used to decrypt PostScript Type 1 font, only with
cairo (default built-in one). This option will disappear soon.
.TP
.B \-help, \-\-help
Display the list of options
.SH SEE ALSO
.BR mpost (1),
.BR ocamlc (1),
.BR xpdf (1).
.br
.SH AUTHOR
Mlpost was written by Romain Bardou,
François Bobot,
Johannes Kanig, Stéphane Lescuyer and
Jean-Christophe Filliâtre.
.PP
This manual page was written by Stéphane Glondu <steph@glondu.net> and
completed by the Mlpost authors
for the Debian project (but may be used by others).