package ocaml-base-compiler
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=2d0f8090951a97a2c0e5b8a11e90096c0e1791d2e471e4a67f87e3b974044cd0
doc/compiler-libs.common/Compile_common/index.html
Module Compile_common
Common compilation pipeline between bytecode and native.
Initialization
type info = {
target : Unit_info.t;
env : Env.t;
ppf_dump : Format.formatter;
tool_name : string;
native : bool;
}
Information needed to compile a file.
val with_info :
native:bool ->
tool_name:string ->
source_file:string ->
output_prefix:string ->
dump_ext:string ->
(info -> 'a) ->
'a
with_info ~native ~tool_name ~source_file ~output_prefix ~dump_ext k
invokes its continuation k
with an info
structure built from its input, after initializing various global variables. This info structure and the initialized global state are not valid anymore after the continuation returns.
Due to current implementation limitations in the compiler, it is unsafe to try to compile several distinct compilation units by calling with_info
several times.
Interfaces
val parse_intf : info -> Parsetree.signature
parse_intf info
parses an interface (usually an .mli
file).
val typecheck_intf : info -> Parsetree.signature -> Typedtree.signature
typecheck_intf info parsetree
typechecks an interface and returns the typedtree of the associated signature.
val emit_signature : info -> Parsetree.signature -> Typedtree.signature -> unit
emit_signature info parsetree typedtree
emits the .cmi
file containing the given signature.
val interface : info -> unit
The complete compilation pipeline for interfaces.
Implementations
val parse_impl : info -> Parsetree.structure
parse_impl info
parses an implementation (usually an .ml
file).
val typecheck_impl : info -> Parsetree.structure -> Typedtree.implementation
typecheck_impl info parsetree
typechecks an implementation and returns the typedtree of the associated module, its public interface, and a coercion against that public interface.
val implementation :
info ->
backend:(info -> Typedtree.implementation -> unit) ->
unit
The complete compilation pipeline for implementations.