|
61 | 61 | <li class="toctree-l3"><a class="reference internal" href="#pull-request-guidelines">Pull Request Guidelines</a></li> |
62 | 62 | <li class="toctree-l3"><a class="reference internal" href="#legal-guidelines">Legal Guidelines</a></li> |
63 | 63 | <li class="toctree-l3"><a class="reference internal" href="#develop-with-nix">Develop with Nix</a></li> |
| 64 | +<li class="toctree-l3"><a class="reference internal" href="#develop-with-opam">Develop with Opam</a></li> |
| 65 | +<li class="toctree-l3"><a class="reference internal" href="#build-the-project-with-makefile">Build the project with Makefile</a></li> |
64 | 66 | <li class="toctree-l3"><a class="reference internal" href="#release-process">Release Process</a><ul> |
65 | 67 | <li class="toctree-l4"><a class="reference internal" href="#make-a-pr-for-the-release">Make a PR for the release</a></li> |
66 | 68 | <li class="toctree-l4"><a class="reference internal" href="#update-documentation">Update documentation</a></li> |
@@ -143,6 +145,49 @@ <h2>Develop with Nix<a class="headerlink" href="#develop-with-nix" title="Permal |
143 | 145 | </pre></div> |
144 | 146 | </div> |
145 | 147 | </section> |
| 148 | +<section id="develop-with-opam"> |
| 149 | +<h2>Develop with Opam<a class="headerlink" href="#develop-with-opam" title="Permalink to this heading"></a></h2> |
| 150 | +<p>If you are using opam, you can set up a switch development for Alt-Ergo using:</p> |
| 151 | +<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>make<span class="w"> </span>dev-switch |
| 152 | +</pre></div> |
| 153 | +</div> |
| 154 | +<p>This command creates a local switch with all the dependencies required for |
| 155 | +building the Alt-Ergo binary and library.</p> |
| 156 | +<p>To install dependencies for the JavaScript artifacts of Alt-Ergo in the |
| 157 | +current switch, run:</p> |
| 158 | +<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>make<span class="w"> </span>js-deps |
| 159 | +</pre></div> |
| 160 | +</div> |
| 161 | +</section> |
| 162 | +<section id="build-the-project-with-makefile"> |
| 163 | +<h2>Build the project with Makefile<a class="headerlink" href="#build-the-project-with-makefile" title="Permalink to this heading"></a></h2> |
| 164 | +<p>Once you have set up a development environment, you can use the following |
| 165 | +Makefile targets to compile different parts of the project:</p> |
| 166 | +<table class="docutils align-default"> |
| 167 | +<thead> |
| 168 | +<tr class="row-odd"><th class="head"><p>Target</p></th> |
| 169 | +<th class="head"><p>Description</p></th> |
| 170 | +</tr> |
| 171 | +</thead> |
| 172 | +<tbody> |
| 173 | +<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">bin</span></code></p></td> |
| 174 | +<td><p>Builds the Alt-Ergo binary and library.</p></td> |
| 175 | +</tr> |
| 176 | +<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">lib</span></code></p></td> |
| 177 | +<td><p>Builds only the Alt-Ergo library.</p></td> |
| 178 | +</tr> |
| 179 | +<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">js</span></code></p></td> |
| 180 | +<td><p>Builds the Alt-Ergo artifacts for JavaScript.</p></td> |
| 181 | +</tr> |
| 182 | +<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">plugins</span></code></p></td> |
| 183 | +<td><p>Builds the Alt-Ergo plugins.</p></td> |
| 184 | +</tr> |
| 185 | +<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">make</span></code></p></td> |
| 186 | +<td><p>Builds everything.</p></td> |
| 187 | +</tr> |
| 188 | +</tbody> |
| 189 | +</table> |
| 190 | +</section> |
146 | 191 | <section id="release-process"> |
147 | 192 | <h2>Release Process<a class="headerlink" href="#release-process" title="Permalink to this heading"></a></h2> |
148 | 193 | <p>Alt-Ergo releases do not have a fixed schedule and are made based on features. We try to maintain the main branch (<code class="docutils literal notranslate"><span class="pre">next</span></code>) of the repository as stable as possible, and cut a release from there when an important feature is complete. We also make point release to fix important bugs.</p> |
|
0 commit comments