File: bootstrapping.pod

package info (click to toggle)
nqp 2020.12%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 8,880 kB
  • sloc: java: 26,979; perl: 3,386; ansic: 450; makefile: 203; javascript: 68; sh: 1
file content (40 lines) | stat: -rw-r--r-- 1,006 bytes parent folder | download | duplicates (2)
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://colabti.org/irclogger/irclogger_log/perl6?date=2010-04-22#l1331>