--- gforth/doc/vmgen.texi 2005/10/02 11:30:34 1.29 +++ gforth/doc/vmgen.texi 2008/10/08 20:54:09 1.33 @@ -10,11 +10,11 @@ This manual is for Vmgen (version @value{VERSION}, @value{UPDATED}), the virtual machine interpreter generator -Copyright @copyright{} 2002,2003,2005 Free Software Foundation, Inc. +Copyright @copyright{} 2002,2003,2005,2007 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the @@ -331,7 +331,7 @@ instructions. Another option is to use for the virtual machine; we believe that using a stack architecture is usually both simpler and faster. -however, this option is slower or +However, this option is slower or significantly more complex to implement than a stack machine architecture. Vmgen has special support and optimizations for stack VMs, making their @@ -860,6 +860,9 @@ first one (just as the intuition suggest @cindex Stack pointer access @cindex explicit stack access +This feature is not needed and not supported in the 0.6.2 version of +vmgen that is documented here (and that is invoked by default). + Not all stack effects can be specified using the stack effect specifications above. For VM instructions that have other stack effects, you can specify them explicitly by accessing the stack @@ -963,13 +966,14 @@ if (branch_condition) @{ SUPER_CONTINUE; @end example -@item VM_JUMP -@findex VM_JUMP -@code{VM_JUMP(target)} is equivalent to @code{goto *(target)}, but -allows Vmgen to do dynamic superinstructions and replication. You -still need to say @code{SUPER_END}. Also, the goto only happens at -the end (wherever the VM_JUMP is). Essentially, this just suppresses -much of the ordinary dispatch mechanism. +@c !! uncomment for post-0.6.2 docs +@c @item VM_JUMP +@c @findex VM_JUMP +@c @code{VM_JUMP(target)} is equivalent to @code{goto *(target)}, but +@c allows Vmgen to do dynamic superinstructions and replication. You +@c still need to say @code{SUPER_END}. Also, the goto only happens at +@c the end (wherever the VM_JUMP is). Essentially, this just suppresses +@c much of the ordinary dispatch mechanism. @end table @@ -1141,7 +1145,7 @@ optimizer for both variations, so leave @cindex stack stores, optimization @cindex eliminating stack stores -This minor optimization (0.6\%--0.8\% reduction in executed instructions +This minor optimization (0.6%--0.8% reduction in executed instructions for Gforth) puts additional requirements on the instruction descriptions and is therefore disabled by default. @@ -1996,6 +2000,8 @@ You can find vmgen information at * GNU Free Documentation License:: License for copying this manual. @end menu +@node GNU Free Documentation License, , Copying This Manual, Copying This Manual +@appendixsec GNU Free Documentation License @include fdl.texi