X-Git-Url: http://git.subgeniuskitty.com/vvhitespace/.git/blobdiff_plain/0c56152e6ad67ef7e311f1e394250279864edd1a..9f7f68e5a8c113ad8de2f6b6e6678e4075739125:/stdlib/README.md diff --git a/stdlib/README.md b/stdlib/README.md index e7ebedd..2bd317e 100644 --- a/stdlib/README.md +++ b/stdlib/README.md @@ -19,9 +19,9 @@ following reservations: ## Heap and Pointers ## The first 16 heap addresses (`0-15`) are reserved when using the stdlib. -Within that reservation, heap[0] is used by `random` and heap[15] is used -by `spewreg`. The remaining 14 locations, heap[1]-heap[14] are used as -general-purpose registers. +Within that reservation, heap[0] is used by `random` and the block +heap[2]-heap[15] by the stack rotation subroutines which time-share these +pseudo-registers between the various stdlib subroutines. By convention, functions which return a pointer will use the address `0` to represent a `NULL` pointer. @@ -37,6 +37,7 @@ header comment for each function to learn the call and return stack. 1001 ----- print number from stack (stdio.pvvs) 1010 ----- stackrotate (stack.pvvs) 1011 ----- stackrotatereverse (stack.pvvs) + 1100 ----- deepdup (stack.pvvs) 010xxx - math functions 10000 ----- random (math.pvvs) 10001 ----- absolute value (math.pvvs) @@ -62,9 +63,12 @@ header comment for each function to learn the call and return stack. 111xxx - debug functions 111000 ----- dump heap (debug.pvvs) 111001 ----- dump stack (debug.pvvs) + 111010 ----- print sign (debug.pvvs) + 111011 ----- print magnitude (debug.pvvs) + 111100 ----- print string (debug.pvvs) 1xxxxxx - reserved for less common entry points - 1000000 ----- slurp registers (heap.pvvs) - 1000001 ----- spew registers (heap.pvvs) + 1000000 ----- lowbitand (logic.pvvs) + 1000001 ----- isnegative (math.pvvs) 1000010 ----- print sign of number (stdio.pvvs) 1000011 ----- print magnitude of number (stdio.pvvs) 1000100 ----- print string from stack (stdio.pvvs)