[project @ 1996-01-08 20:28:12 by partain]
[ghc.git] / ghc / docs / NOTES.mkworld2
1 Include order:
2
3 # platform info
4 #   discrim on "trigger" symbols in plat-TRIGGER.jm
5 #   then slurp in plat-<platform>.jm
6 #   *-GEN has defaults [if any]
7
8 plat-TRIGGER.jm
9 plat-<platform>.jm
10 plat-GEN.jm
11
12 # site overrides
13
14 site-<project>-<setup>.jm
15 site-<project>.jm
16 site-GEN.jm
17
18 # <thing>s just for a <project> and its various <setup>s
19
20 <thing>-<project>-<setup>.jm
21 <thing>-<project>.jm
22
23 # things that many projects are likely to use
24
25 <thing>-GEN.jm
26
27 # finally, the directory-specific stuff
28
29 Jmakefile
30
31 -------------------------------------------------------------------
32 must specify platform explicitly
33 setup "std", project "none": nothing included
34
35 -------------------------------------------------------------------
36 <Things> that we have files for:
37
38 rules:          macros related to the main "make" targets
39                 excpt suffix, everything to make "make" do something is here
40                 org by principal make target (all, install, etc.)
41
42 suffix:         things to do w/ make suffix rules (i.e., implicit rules)
43
44 utils:          utilities that are used in the build process
45                 (where they are & default options for them)
46                 (proj file must say which sysutils it wants)
47                 (the proj files say whether src with or not ==> INeedXXX)
48 install:        where things are installed, flags for installing