basis/compiler/cfg/representations/representations-docs.factor

   1 USING: compiler.cfg compiler.cfg.registers cpu.architecture
   2 help.markup help.syntax ;
   3 IN: compiler.cfg.representations
   4
   5 HELP: select-representations
   6 { $values { "cfg" cfg } }
   7 { $description "Entry point for the representation selection compiler pass. After this word hasn run, the " { $link representations } " hashtable has been filled with vregs and what their preferred representations are." } ;
   8
   9 ARTICLE: "compiler.cfg.representations" "Virtual register representation selection"
  10 "Virtual register representation selection. This is where decisions about integer tagging and float and vector boxing are made. The appropriate conversion operations inserted after a cost analysis."
  11 $nl
  12 "Good representation selection is very important for Factor because it uses tagged pointers. If the best representations are selected, then the number of conversions between " { $link int-rep } " and " { $link tagged-rep } " is minimized."
  13 $nl
  14 "Entry point:"
  15 { $subsections select-representations } ;
  16
  17 ABOUT: "compiler.cfg.representations"