SYNOPSISmeltbuild [OPTIONS] [OTHER_FILES] MAIN_FILE
meltbuild compiles Melt sources (.mlt files) into DVI, PostScript (.ps) or PDF files. It first calls the Melt preprocessor meltpp. It then calls the OCaml compiler, either directly or through Ocamlbuild or Mlpost. The program is linked with the Melt and Latex libraries. The program is then executed, producing .tex files. Then latex or pdflatex is called to produce the document.
The MAIN_FILE is the main file of your document. It is the one which will be compiled, executed, and whose produced .tex file will be compiled. OTHER_FILES will be copied into the _melt directory. They are additional files needed to compile your document, such as modules, class styles or included figures.
If one OTHER_FILE has extension .mlt, it will also be pre-processed. Typically, a .mlt file has two usages. The first one is to define values usable by the main .mlt file. The second one is to call the emit function to produce .tex files that can be included in your main .tex file. This is especially useful if your main .tex file is not written in Melt.
Note that if you want an OTHER_FILE to be compiled and executed, you have to use it in the MAIN_FILE so that Ocamlbuild links it. If you do not use Ocamlbuild, multi-modules documents are not supported.
- -meltpp <binary>
- Specify the location and name of the Melt pre-processor binary.
- -latop <binary>
- Specify the location and name of the Latop binary.
- -mlpost <binary>
- Specify the location and name of the Mlpost wrapper binary.
Do not pass a -latex option to the Mlpost wrapper. By default, the .tex file produced by your Melt document is given to Mlpost so it can compute a prelude to be used when compiling images. This option disables this behavior.
The prelude is the contents of the .tex file before the document environment begins.
- -latex <binary>
- Specify the latex command to use.
- -P <path>
- Specify the location of pre-processor plugins. This option is passed to the Melt pre-processor.
- -I <path>
- Look for additional OCaml libraries in the given directory. This option is passed to the OCaml compiler.
- -L <path>
- Add a link to the path in the _melt directory. Useful if you don't want to copy the contents of the directory.
- Give the -classic-display option to Ocamlbuild. Useful if your terminal does not handle the Ocamlbuild animation or if you want to keep a trace of the sequence of commands which are called. Has no effect if it is Mlpost that calls Ocamlbuild.
- Do not use the Mlpost wrapper, call Ocamlbuild directly instead (or the OCaml compiler if -no-ocamlbuild is given too). Unspecified if your document produces Mlpost images.
- Do not use Ocamlbuild to compile your program. The OCaml compiler will be called directly. Usually only makes sense if your source code is made of only one file, and if you are using an OCaml version older than 3.10.2.
- Do not produce the final document, i.e. do not call latex. The MAIN_FILE will still be compiled and executed.
- By default, a symbolic link to the produced DVI, PS or PDF document is created in the current directory. This option disables this behavior.
- Compile the program to native code bytecode instead of bytecode.
- Produce a DVI instead of a PS file.
- Produce a PS file. This is the default behavior.
- Produce a PDF instead of a PS file.
- Produce a PS file, then convert it to PDF using ps2pdf. Useful if pdflatex won't compile your document.
- Use the Cairo backend of Mlpost, instead of Metapost. Implies -pdf.
- Use the native MPS backend of Mlpost, instead of Metapost. Implies -pdf.
- -quiet, -q
- Be quiet. Less messages will be printed on the terminal, if any.
- Continue on errors.
- -fake, -n
- Do not actually execute commands. Useful if you want to know what the Melt tool would execute to compile your document.
- -melt-dir <path>
- Change the name used for the _melt directory.
- Remove the _melt directory and, if not -no-link, all symbolic links of the current directory linking into _melt. Cleaning is done before anything else.
- Print the version number of Melt.
- Pass the remaining arguments to the generated program.
- -help, --help
- Display the list of options
AUTHORMelt was written by Romain Bardou. Contributors include Vincent Aravantinos, Francois Bobot, Pierre Chambart and Arnaud Spiwack.
This manual page was written by Romain Bardou (but may be used by others).