Data stack: ( n -- a )
+X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;ds=sidebyside;f=reference.html;h=41b019023b1af32bf74615ca410080ca0b93aa9c;hb=3615a7d1910cea3c791916293b06b757c2879be9;hp=9cb4b59609eabf30834431443a2a66a96331f340;hpb=3080215f0d03403858b04f5bab8332a9b66a4adf;p=rrq%2Frrqforth.git diff --git a/reference.html b/reference.html index 9cb4b59..41b0190 100644 --- a/reference.html +++ b/reference.html @@ -786,7 +786,8 @@ asciidoc.install(); >R R@ R> -R[n]
+R[n] +D[n]DATA-STACK RETURN-STACK @@ -864,6 +865,7 @@ asciidoc.install(); PROGRAM_VERSION
READ-STREAM-CHAR +READ-STREAM-LINE READ-WORD REALLOC RETURN @@ -884,6 +886,7 @@ asciidoc.install();
TELL .TEMP TEMP +TEMPHELD TEMPSPACE TERMINATE0 TFA>CFA @@ -1194,6 +1197,19 @@ also is incremented accordingly.
Data stack: ( n -- a )
+"D[n]" is a function word that pushes the address for the n:th cell of +the data stack onto the data stack.
"ARGS" is a value word that holds a pointer to the command line data block which consists of a count cell followed by that many asciiz -pointers and then a 0 cell.
ARGS -> 8 bytes: count of non-zero asciiz pointers following
8 bytes: command name string
- 8 bytes: first argument string
- 8* ...
- 8 zero
+ 8* bytes: argument strings
+ 8 bytes: zero cell
+ 8* bytes: envirnment strings
+ 8 bytes: zero cell
Data stack: ( n -- a )
"R[n]" is a function word that pushes the address for the n:th cell on -the top return stack value onto the data stack.
"R[n]" is a function word that pushes the address for the n:th cell of +the return stack onto the data stack.
Data stack: ( stream -- n )
+"READ-STREAM-LINE" is a function word that gets the next line from the +given stream buffer into PAD and returns number of characters. If the +stream is backed by a file descriptor, the stream buffer is refilled +from there as needed, by a SYS_READ call when more characters are +needed.
Data stack: ( -- a )
+"TEMPHELD" is a variable word that keeps the lowest offset of the +TEMPSPACE space to reuse upon cycling. The space +below TEMPHELD is "held" in the sense of not being reused upon +cycling. An application may change the TEMPSPACE offset as needed to +dynamically preserve memory longer term.