File: bootstrapping.pod

package info (click to toggle)
nqp 2024.09%2Bdfsg-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 9,972 kB
  • sloc: java: 28,087; perl: 3,479; ansic: 451; makefile: 202; javascript: 68; sh: 1
file content (40 lines) | stat: -rw-r--r-- 987 bytes parent folder | download
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
=head1 Bootstrapping procedure for NQP

NPQ is a bootstrapped compiler, which means that it uses itself to compile
itself.

To make the first compilation possible under MoarVM, a compiled version of the
compiler is stored in F<src/vm/moar/stage0/*.moarvm> and included in the source
code repository.

When you make changes to the compiler, eventually you need to update these
I<stage0> files.

Here is how you proceed to update the MoarVM bootstrapping files in NQP.  At
any stage, if C<make test> fails, don't go ahead with the following steps, but
fix the problem first.

(Note: the equivalent under JVM is F<src/vm/jvm/stage0/*.jar> with the update 
target C<make j-bootstrap-files>)

=over

=item *

Make your changes, run C<make test>

=item *

Run C<make m-bootstrap-files> and C<make test>

=item *

Commit the non-bootstrap files that you modified yourself

=item *

Commit the bootstrap files

=back

Historic References: L<https://irclogs.raku.org/perl6/2010-04-22.html#16:21>