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>
|