File: INSTALL.md

package info (click to toggle)
rocq-stdlib 9.0.0-3
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 11,828 kB
  • sloc: python: 2,928; sh: 444; makefile: 319; javascript: 24; ml: 2
file content (49 lines) | stat: -rw-r--r-- 1,567 bytes parent folder | download | duplicates (3)
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
Installing From Sources
=======================

To install and use Rocq, we recommend relying on [the Rocq
platform](https://github.com/coq/platform/) or on a package manager
(e.g. opam or Nix).

See https://coq.inria.fr/download and
https://github.com/coq/coq/wiki#coq-installation to learn more.

If you need to build the stdlib from sources manually (e.g. to
contribute to the stdlib or to write a Rocq package), the remainder of this
file explains how to do so.

Build Requirements
------------------

To compile the stdlib yourself, you need:

- [Rocq](https://github.comq/coq/coq)
  Look into [rocq-stdlib.opam](./rocq-stdlib.opam) for supported versions.

Opam (https://opam.ocaml.org/) is recommended to install Rocq.

    $ opam switch create rocq --packages="ocaml-variants.4.14.1+options,ocaml-option-flambda"
    $ eval $(opam env)
    $ opam install rocq-core

should get you a reasonable Rocq environment to compile the stdlib.
See the OPAM documentation for more help.

Nix users can also get all the required dependencies by running:

    $ nix-shell

Build and install procedure
---------------------------

To build and install the stdlib do:

    $ make
    $ make install

Then, the recommended way to require standard library modules is `From
Stdlib Require {Import,Export,} <LibraryModules>.`, except for `Byte`
(use `From Stdlib.Strings` or `From Stdlib.Init`), `Tactics` (use
`From Stdlib.Program` or `From Stdlib.Init`), `Tauto` (use `From
Stdlib.micromega` of `From Stdlib.Init`) and `Wf` (use `From
Stdlib.Program` or `From Stdlib.Init`).