1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
|
(************************************************************************)
(* * The Coq Proof Assistant / The Coq Development Team *)
(* v * Copyright INRIA, CNRS and contributors *)
(* <O___,, * (see version control and CREDITS file for authors & dates) *)
(* \VV/ **************************************************************)
(* // * This file is distributed under the terms of the *)
(* * GNU Lesser General Public License Version 2.1 *)
(* * (see LICENSE file for the text of the license) *)
(************************************************************************)
(** Main etry point to the sysinit component, all other modules are private.
The following API shoud be called in order, and the first 3 steps only once
since they initialize global data. On the contrary step 4 can be called
many times to init the compilation of a unit.
*)
(** 1 initialization of OCaml's runtime
Profiling, GC parameters and signals. Nothing specific to Coq per se, but
the defaults here are good for Coq.
This API should be called up very early, or not at all. *)
val init_ocaml : unit -> unit
(** 2 parsing of Sys.argv
This API parses command line options which are known by Coq components.
Ideally it is functional, but some values in the `Flags` modules are set
on the spot instead of being represented as "injection commands" (a field
of Coqargs.t).
[parse_extra] and [usage] can be used to parse/document more options. *)
val parse_arguments :
parse_extra:(string list -> 'a * string list) ->
usage:Boot.Usage.specific_usage ->
?initial_args:Coqargs.t ->
unit ->
Coqargs.t * 'a
(** 3 initialization of global runtime data
All global setup is done here, like COQLIB and the paths for native
compilation. If Coq is used to process multiple libraries, what is set up
here is really global and common to all of them.
The returned injections are options (as in "Set This Thing" or "Require
that") as specified on the command line.
The prelude is one of these (unless "-nois" is passed).
This API must be called, typically jsut after parsing arguments. *)
val init_runtime : Coqargs.t -> Coqargs.injection_command list
(** 4 Start a library (sets options and loads objects like the prelude)
Given the logical name [top] of the current library and the set of initial
options and required libraries, it starts its processing (see also
Declaremods.start_library) *)
val start_library :
intern:Library.Intern.t -> top:Names.DirPath.t -> Coqargs.injection_command list -> unit
|