The unpac monorepo manager self-hosting as a monorepo using unpac
Asciidoctor: fix errors
+12
-12
+4
-4
BOOTSTRAP.adoc
+4
-4
BOOTSTRAP.adoc
···
53
53
54
54
make bootstrap
55
55
56
-
= Problems
56
+
== Problems
57
57
58
58
If you notice that this procedure fails for a given change you are
59
59
trying to implement, please report it so that the procedure can be
60
60
updated to also cope with your change.
61
61
62
-
= Upstreaming
62
+
== Upstreaming
63
63
64
64
If you want to upstream your changes, indicate in the message of the
65
65
commit that the changes need a bootstrap. Perform the bootstrap and
66
66
commit the result of the bootstrap separately, after that commit.
67
67
68
-
= Adding, removing and renaming primitives
68
+
== Adding, removing and renaming primitives
69
69
70
70
Primitives can be added without having to bootstrap, however it is necessary
71
71
to repeat `make coldstart` in order to use your new primitive in the standard
···
110
110
make coreall
111
111
make bootstrap
112
112
113
-
= Bootstrap test script
113
+
== Bootstrap test script
114
114
115
115
A script is provided (and used on Inria's continuous
116
116
integration infrastructure) to make sure the bootstrap works. This
+2
-2
HACKING.adoc
+2
-2
HACKING.adoc
···
8
8
If you already have a patch that you would like to contribute to the
9
9
official distribution, please see link:CONTRIBUTING.md[].
10
10
11
-
=== Your first compiler modification
11
+
== Your first compiler modification
12
12
13
13
1. Create a new git branch to store your changes.
14
14
+
···
53
53
See also our <<tips,development tips and tricks>>, for example on how to
54
54
<<opam-switch,create an opam switch>> to test your modified compiler.
55
55
56
-
=== What to do
56
+
== What to do
57
57
58
58
There is always a lot of potential tasks, both for old and
59
59
newcomers. Here are various potential projects:
+3
-3
README.adoc
+3
-3
README.adoc
···
1
+
= README
2
+
1
3
[CAUTION]
2
4
====
3
5
The developer team released OCaml 5.0.0 in December 2022. OCaml 5.x features a
···
37
39
image:https://ci.appveyor.com/api/projects/status/github/ocaml/ocaml?branch=4.14&svg=true["AppVeyor Build Status (4.14 branch)",
38
40
link="https://ci.appveyor.com/project/avsm/ocaml"]
39
41
|=====
40
-
41
-
= README =
42
42
43
43
== Overview
44
44
···
166
166
| https://github.com/garrigue/labltk/issues[The LablTk library] | OCaml 4.02 | `labltk`
167
167
| https://github.com/ocaml/dbm/issues[The CamlDBM library] | OCaml 4.00 | `dbm`
168
168
| https://github.com/xavierleroy/ocamltopwin/issues[The OCamlWinTop Windows toplevel] | OCaml 4.00 | none
169
-
|=====
169
+
|====
+2
-2
parsing/HACKING.adoc
+2
-2
parsing/HACKING.adoc
···
13
13
generator, which is an external tool that you need to install if you
14
14
wish to modify the parser.
15
15
16
-
=== Working on the parser grammar
16
+
== Working on the parser grammar
17
17
18
18
To avoid depending on an external tool, the compiler build system does
19
19
not rebuild the parser from the source grammar link:parser.mly[] each
···
25
25
link:../Makefile.menhir[] for the details of the various
26
26
Menhir-related targets and their use.
27
27
28
-
==== Testing the grammar
28
+
=== Testing the grammar
29
29
30
30
The root Makefile contains a `build-all-asts` target that will build,
31
31
for each source `.ml` or `.mli` file in the repository, a `.ml.ast` or
+1
-1
testsuite/HACKING.adoc
+1
-1
testsuite/HACKING.adoc
···
134
134
| `1` or unset | 2 cores, 2 Gb RAM | 32 or 64 bits
135
135
| `2` | 4 cores, 4 Gb RAM | 64 bits
136
136
| `3` | 8 cores, 8 Gb RAM | 64 bits
137
-
|=====
137
+
|====
138
138
139
139
Tests, then, can check the `OCAML_TEST_SIZE` environment variable and
140
140
increase the number of cores or the amount of memory used. The