allocate without locking (locked mem is limited)

[rrq/rrqforth.git] / adoc / inline_code.adoc

diff --git a/adoc/inline_code.adoc b/adoc/inline_code.adoc
index 91bb246ed899fc8bb63c12b5660ffa992a77666c..d85166c1bce422449758b875519825abb9cc138a 100644 (file)
--- a/adoc/inline_code.adoc
+++ b/adoc/inline_code.adoc
@@ -1,11 +1,25 @@
+// rrqforth.asm:       WORD inline_code,'[ASM]',fasm
+
 anchor:inline_code[]
 
-Word: [ASM]
-----------
+=== Word: [ASM]
+
+....
+data stack: ( -- )
+....
 
+"[ASM]" is a function word that introduces inline assembly in an
+RRQFORTH definition. Such assembly code may return to subsequence
+RRQFORTH executon by means of the following instruction sequence:
+
+====
 ----
-rrqforth.asm:  WORD inline_code,'[ASM]',fasm
+       mov rsi,forthcode
+       lodsq
+       jmp qword [rax]
+forthcode:
 ----
+====
 
-"[ASM]" is a function word that introduces inlined assembly.
-
+Note that the FORTH compiler does not invoke an assembler so any
+inline assembly code must be provided in its binary form.