@@ -10,7 +10,7 @@ linkcolor: blue
10
10
This document describes the general strategy for testing Proof General
11
11
with GitHub actions and for building the necessary containers.
12
12
13
- The file ` .github/workflows/test.yml ` defines 5 jobs.
13
+ The file ` .github/workflows/test.yml ` defines 6 jobs.
14
14
15
15
build
16
16
: compile Proof General sources to bytecode and build documentation
@@ -26,25 +26,28 @@ compile-tests
26
26
: run the auto-compilation tests in ` ci/compile-tests `
27
27
28
28
simple-tests
29
- : run the tests in ` ci/simple-tests `
29
+ : run the Coq tests in ` ci/simple-tests `
30
30
31
31
test-indent
32
32
: run Coq source code indentation tests
33
-
34
- The jobs build, check-doc-magic and test-indent run on different Emacs
35
- versions but they do not need Coq. They therefore use the GitHub
36
- hosted ubuntu-latest runner together with the ` purcell/setup-emacs `
37
- action to install Emacs.
33
+
34
+ test-qrhl
35
+ : run the qRHL tests in ` ci/simple-tests `
36
+
37
+ The jobs build, check-doc-magic, test-indent and test-qrhl run on
38
+ different Emacs versions but they do not need Coq. They therefore use
39
+ the GitHub hosted ubuntu-latest runner together with the
40
+ ` purcell/setup-emacs ` action to install Emacs.
38
41
39
42
The jobs test, compile-tests and simple-tests need Coq and Emacs in
40
43
different version pairs. They therefore use the
41
- ` proofgeneral/coq-emacs ` containers build specifically for various
42
- Coq/Emacs version pairs for this purpose. This is achieved by
43
- installing Nix on specific containers from ` coqorg/coq ` , see
44
- ` proofgeneral/coq-nix ` , and then installing Emacs via Nix. There
45
- are GitLab and GitHub projects for building these containers in GitLab
46
- pipelines. However, currently this does not work and the containers
47
- are therefore build manually.
44
+ ` proofgeneral/coq-emacs ` docker containers build specifically for
45
+ various Coq/Emacs version pairs for this purpose. This is achieved by
46
+ installing Nix on specific containers from ` coqorg/coq ` , see the
47
+ ` proofgeneral/coq-nix ` docker repository , and then installing Emacs
48
+ via Nix. There are GitLab and GitHub projects for building these
49
+ containers in GitLab pipelines. However, currently this does not work
50
+ and the containers are therefore build manually.
48
51
49
52
This document ignores Coq point releases (e.g., 8.13.2). For one
50
53
reason we trust the Coq development team to not introduce changes in
@@ -108,7 +111,7 @@ of the following points is true for *cv* and *ev*.
108
111
109
112
#. The Coq version * cv* has been released within the last two years.
110
113
111
- This point is motivated by the ability to reproduce Problems for
114
+ This point is motivated by the ability to reproduce problems for
112
115
recent Coq versions.
113
116
114
117
#. The pair (* cv* , * ev* ) is an historic pair, in the sense that both
179
182
Currently only actively supported versions are tested via GitHub
180
183
actions.
181
184
182
- ## Compilation and indentation
185
+ ## Compilation, indentation and qRHL
183
186
184
- The tests defined for the build and test-indent jobs run for all
185
- actively supported Emacs versions.
187
+ The tests defined for the build, test-indent and test-qrhl jobs run
188
+ for all actively supported Emacs versions.
186
189
187
190
## Up-to-date documentation strings in the manuals
188
191
189
192
The error scenario here is that a documentation string that is
190
193
magically included in the manuals has been updated without updating
191
194
the manuals via ` make magic ` . It is therefore sufficient to run the
192
195
test whether the manuals are up-to-date with only the latest two Emacs
193
- versions.
196
+ major versions.
194
197
195
198
## Proof General interaction tests with Coq {#coq-ci}
196
199
0 commit comments