2011-07-27 07:17:02 -07:00
|
|
|
.\"***********************************************************************
|
|
|
|
|
.\"* *
|
|
|
|
|
.\"* OCaml *
|
|
|
|
|
.\"* *
|
|
|
|
|
.\"* Xavier Leroy, projet Cristal, INRIA Rocquencourt *
|
|
|
|
|
.\"* *
|
|
|
|
|
.\"* Copyright 1999 Institut National de Recherche en Informatique et *
|
|
|
|
|
.\"* en Automatique. All rights reserved. This file is distributed *
|
|
|
|
|
.\"* under the terms of the Q Public License version 1.0. *
|
|
|
|
|
.\"* *
|
|
|
|
|
.\"***********************************************************************
|
|
|
|
|
.\"
|
1999-02-25 06:25:54 -08:00
|
|
|
.TH OCAMLMKTOP 1
|
|
|
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
|
ocamlmktop \- Building custom toplevel systems
|
|
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B ocamlmktop
|
|
|
|
|
[
|
2010-05-20 07:06:29 -07:00
|
|
|
.BR \-v | \-version | \-vnum
|
1999-02-25 06:25:54 -08:00
|
|
|
]
|
|
|
|
|
[
|
|
|
|
|
.BI \-cclib \ libname
|
|
|
|
|
]
|
|
|
|
|
[
|
|
|
|
|
.BI \-ccopt \ option
|
|
|
|
|
]
|
|
|
|
|
[
|
|
|
|
|
.B \-custom
|
|
|
|
|
[
|
|
|
|
|
.BI \-o \ exec-file
|
|
|
|
|
]
|
|
|
|
|
[
|
|
|
|
|
.BI \-I \ lib-dir
|
|
|
|
|
]
|
|
|
|
|
.I filename ...
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
|
2008-09-15 07:05:30 -07:00
|
|
|
The
|
1999-02-25 06:25:54 -08:00
|
|
|
.BR ocamlmktop (1)
|
2011-04-26 05:16:50 -07:00
|
|
|
command builds OCaml toplevels that
|
1999-02-25 06:25:54 -08:00
|
|
|
contain user code preloaded at start-up.
|
2008-09-15 07:05:30 -07:00
|
|
|
The
|
1999-02-25 06:25:54 -08:00
|
|
|
.BR ocamlmktop (1)
|
|
|
|
|
command takes as argument a set of
|
2008-09-15 07:05:30 -07:00
|
|
|
.IR x .cmo
|
1999-02-25 06:25:54 -08:00
|
|
|
and
|
2008-09-15 07:05:30 -07:00
|
|
|
.IR x .cma
|
2011-04-26 05:16:50 -07:00
|
|
|
files, and links them with the object files that implement the
|
|
|
|
|
OCaml toplevel. If the
|
2008-09-15 07:05:30 -07:00
|
|
|
.B \-custom
|
1999-02-25 06:25:54 -08:00
|
|
|
flag is given, C object files and libraries (.o and .a files) can also
|
|
|
|
|
be given on the command line and are linked in the resulting toplevel.
|
|
|
|
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
|
2008-09-15 07:05:30 -07:00
|
|
|
The following command-line options are recognized by
|
1999-02-25 06:25:54 -08:00
|
|
|
.BR ocamlmktop (1).
|
|
|
|
|
.TP
|
|
|
|
|
.B \-v
|
2010-05-20 07:06:29 -07:00
|
|
|
Print the version string of the compiler and exit.
|
|
|
|
|
.TP
|
2013-02-26 02:36:33 -08:00
|
|
|
.BR \-vnum \ or\ \-version
|
2010-05-20 07:06:29 -07:00
|
|
|
Print the version number of the compiler in short form and exit.
|
1999-02-25 06:25:54 -08:00
|
|
|
.TP
|
2008-09-15 07:05:30 -07:00
|
|
|
.BI \-cclib\ \-l libname
|
|
|
|
|
Pass the
|
1999-02-25 06:25:54 -08:00
|
|
|
.BI \-l libname
|
|
|
|
|
option to the C linker when linking in
|
|
|
|
|
``custom runtime'' mode (see the corresponding option for
|
|
|
|
|
.BR ocamlc (1).
|
|
|
|
|
.TP
|
|
|
|
|
.B \-ccopt
|
|
|
|
|
Pass the given option to the C compiler and linker, when linking in
|
|
|
|
|
``custom runtime'' mode. See the corresponding option for
|
|
|
|
|
.BR ocamlc (1).
|
|
|
|
|
.TP
|
|
|
|
|
.B \-custom
|
|
|
|
|
Link in ``custom runtime'' mode. See the corresponding option for
|
|
|
|
|
.BR ocamlc (1).
|
|
|
|
|
.TP
|
2008-09-15 07:05:30 -07:00
|
|
|
.BI \-I \ directory
|
1999-02-25 06:25:54 -08:00
|
|
|
Add the given directory to the list of directories searched for
|
|
|
|
|
compiled interface files (.cmo and .cma).
|
|
|
|
|
.TP
|
2008-09-15 07:05:30 -07:00
|
|
|
.BI \-o \ exec\-file
|
1999-02-25 06:25:54 -08:00
|
|
|
Specify the name of the toplevel file produced by the linker.
|
2008-09-15 07:05:30 -07:00
|
|
|
The default is is
|
1999-02-25 06:25:54 -08:00
|
|
|
.BR a.out .
|
|
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR ocamlc (1).
|
