steve
/
factor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Docs: smallish improvements to compiler vocabs

db4
Björn Lindqvist 2014-11-15 07:56:36 +01:00 committed by John Benediktsson
parent bc5c23b162
commit f06f59b956
3 changed files with 30 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
basis/compiler/cfg/def-use/def-use-docs.factor
View File

@ -22,3 +22,7 @@ HELP: uses-vregs
"{ 37 }" "{ 37 }"
} }
} ; } ;
HELP: temp-vregs
{ $values { "insn" insn } { "seq" sequence } }
{ $description "Returns the sequence of temporary vregs used by this instruction." } ;

6
basis/compiler/cfg/liveness/liveness-docs.factor Normal file
View File

@ -0,0 +1,6 @@
USING: compiler.cfg.instructions help.markup help.syntax ;
IN: compiler.cfg.liveness
HELP: fill-gc-map
{ $values { "live-set" "no idea" } { "insn" insn } }
{ $description "Assigns values to the " { $slot "gc-roots" } " and " { $slot "derived-roots" } " slots of an instructions " { $link gc-map } "." } ;

22
basis/cpu/architecture/architecture-docs.factor
View File

@ -1,4 +1,4 @@
USING: assocs alien compiler.cfg.instructions cpu.x86.assembler USING: assocs alien classes compiler.cfg.instructions cpu.x86.assembler
cpu.x86.assembler.operands help.markup help.syntax kernel cpu.x86.assembler.operands help.markup help.syntax kernel
layouts literals math multiline system words ; layouts literals math multiline system words ;
IN: cpu.architecture IN: cpu.architecture
@ -58,6 +58,10 @@ HELP: signed-rep
{ $values { "rep" representation } { "rep'" representation } } { $values { "rep" representation } { "rep'" representation } }
{ $description "Maps any representation to its signed counterpart, if it has one." } ; { $description "Maps any representation to its signed counterpart, if it has one." } ;
HELP: rep-size
{ $values { "rep" representation } { "n" integer } }
{ $description "Size in bytes of a representation." } ;
HELP: immediate-arithmetic? HELP: immediate-arithmetic?
{ $values { "n" number } { "?" boolean } } { $values { "n" number } { "?" boolean } }
{ $description { $description
@ -135,6 +139,10 @@ HELP: return-regs
{ $values { "regs" assoc } } { $values { "regs" assoc } }
{ $description "What registers that will be used for function return values of which class." } ; { $description "What registers that will be used for function return values of which class." } ;
HELP: return-struct-in-registers?
{ $values { "c-type" class } { "?" "a boolean" } }
{ $description "Whether the size of the struct is so small that it will be returned in registers or not." } ;
HELP: stack-cleanup HELP: stack-cleanup
{ $values { $values
{ "stack-size" integer } { "stack-size" integer }
@ -165,4 +173,14 @@ $nl
test-instruction? test-instruction?
} }
"Control flow code emitters:" "Control flow code emitters:"
{ $subsections %call %jump %jump-label %return } ; { $subsections %call %jump %jump-label %return }
"Representation metadata:"
{ $subsections
narrow-vector-rep
rep-component-type
rep-length
rep-size
scalar-rep-of
signed-rep
widen-vector-rep
} ;