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