package coq

  1. Overview
  2. Docs
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Module Boot.EnvSource

Coq runtime enviroment API.

This module provides functions for manipulation of Coq's runtime enviroment, including the standard directories and support files.

This API is similar in spirit to findlib's or dune-sites API, see their documentation for more information:

  • http://projects.camlcity.org/projects/dl/findlib-1.9.1/doc/ref-html/lib/index.html
  • https://dune.readthedocs.io/en/stable/sites.html#sites

It is important that this library has a minimal dependency set.

The Coq runtime enviroment needs to be properly initialized before use; we detail the rules below. It is recommended that applications requiring multiple accesses to the environment, do initialize it once and keep a ref to it. We don't forbid yet double initialization, (second time is a noop) but we may do so in the future. Rules for "coqlib" are:

  • the COQLIB env variable will be used if set
  • if not, the existence of theories/Init/Prelude.vo will be checked, in the following order:
  1. coqlibsuffix given in configure
  2. coqlib given in configure
  • if none of the above succeeds, the initialization will fail
  • The COQCORELIB env variable is also used if set, if not, the location of the coq-core files will be assumed to be COQLIB/../coq-core, except if COQLIB/plugins exists as in some developers layouts, in which case we will set COQCORELIB:=COQLIB.

Note that set_coqlib is used by some commands to process the -coqlib option, as of now this sets both coqlib and coqcorelib; this part of the initialization will be eventually moved here.

The error handling policy of this module is simple for now: failing to initialize Coq's env will produce a fatal error, and the application will exit with code 1. No error handling is thus required on the client yet.

Sourcemodule Path : sig ... end

This API is loosely inspired by Stdune.Path, for now we keep it minimal, but at some point we may extend it.

Sourcetype t

Coq runtime enviroment, including location of Coq's stdlib

Sourceval init : unit -> t

init () will initialize the Coq environment.

Sourceval stdlib : t -> Path.t

stdlib directory

Sourceval plugins : t -> Path.t

plugins directory

Sourceval user_contrib : t -> Path.t

user contrib directory

Sourceval tool : t -> string -> Path.t

tool-specific directory

Sourceval native_cmi : t -> string -> Path.t

.cmi files needed for native compilation

Sourceval revision : t -> Path.t

The location of the revision file

Sourceval corelib : t -> Path.t

coq-core/lib directory, not sure if to keep this

Sourceval coqlib : t -> Path.t

coq/lib directory, not sure if to keep this

Sourceval set_coqlib : string -> unit

Internal, should be set automatically by passing cmdline args to init; note that this will set both coqlib and corelib for now.

OCaml

Innovation. Community. Security.