Module B0_defSource

b0 definitions.

b0 definitions are uniquely named OCaml values of different types used for describing software construction. The value names are used for end-user interaction.

b0 definitions occur in various b0 files and libraries during the module initialisation phase of the program consuming the definitions. After the module initialisation phase no new definition is allowed.

This module handle the management of these named values in B0 files and libraries. It provides the infrastructure to track the location of their definition, properly scope the names, check their unicity in the scope, index them and make sure they cannot be defined after the module initialisation phase of the program.

Definitions

Sourcetype t

The type for definition names and their scoping information.

Sourcetype def = t

See t.

Sourceval scope : t -> B0_scope.t

scope d is the scope in which d is defined.

Sourceval file : t -> B0_std.Fpath.t option

file d is the absolute file path in which d is defined, if defined in a file.

Sourceval scope_dir : t -> B0_std.Fpath.t option

scope_dir is the parent of file d.

Sourceval name : t -> string

name d is the qualified name of d.

Sourceval doc : t -> string

doc d is a one-line documentation string for d.

Sourceval meta : t -> B0_meta.t

meta is the metadata associated to the definition.

Defining values

Sourcemodule type VALUE = sig ... end

The type for values to be named.

Sourcemodule type S = sig ... end

The type of named values.

Sourcemodule Make (V : VALUE) : S with type t = V.t

Make (V) names the values of V.

Sourcetype value =
  1. | V : (module S with type t = 'a) * 'a -> value