Stack Comments

Stack Comments are a conventional notation in Forth that specify the arguments that a word expects, and the results it will return. It is usual for a Forth word to consume its arguments. A stack comment looks like this;

   ( a b c--d e)
The arguments come before the "--", and the results after. In each instance the rightmost item (respectively "c" and "e" in the example), is on the top of the stack. It is usual for stack comments to carry data type information, where it is required (ie n1 would be a signed integer, addr2 would be an address).
That was Interesting