[Plib-cvs] plib/doc/psl impl_guide.html,NONE,1.1 prog_guide.html,1.11,1.12
Brought to you by:
sjbaker
Menu
▾
▴
[Plib-cvs] plib/doc/psl impl_guide.html,NONE,1.1 prog_guide.html,1.11,1.12
|
From: Steve B. <sj...@us...> - 2002-09-22 15:22:24
|
Update of /cvsroot/plib/plib/doc/psl
In directory usw-pr-cvs1:/tmp/cvs-serv23622/plib/doc/psl
Modified Files:
prog_guide.html
Added Files:
impl_guide.html
Log Message:
Changed the expression handler to handle the difference between an
lvalue and an rvalue. This enabled the assignment statement code to
be moved down into expression handling where it belongs. Hence multiple
assignments - and assignments tucked away in weird places should now
work.
--- NEW FILE: impl_guide.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>The PLIB Scripting Language: Implementation Guide.</title>
</head>
<body text="#B5A642" bgcolor="#005000" link="#8FFF8F" vlink="#18A515" alink="#20336B" background="../marble.png">
<table>
<tr>
<td>
<center>
<h1>The PSL Implementation Guide.</h1></center>
<center>By Steve Baker</center>
</td>
</tr>
</table>
<H1>Introduction</H1>
This document describes the virtual machine that the PSL byte code
interpreter implements.
[...237 lines suppressed...]
<H3> OPCODE_INCREMENT_FETCH <\H3>
<H3> OPCODE_DECREMENT_FETCH <\H3>
INTRUCTION BYTES: 1 <br>
EFFECT: The index of a variable is on top of the stack, replace it
with the value of that variable. Post-increment/decrement the
variable.
<H3> OPCODE_INCREMENT_LVALUE <\H3>
<H3> OPCODE_DECREMENT_LVALUE <\H3>
INTRUCTION BYTES: 1 <br>
EFFECT: The index of a variable is on top of the stack.
Increment/decrement the variable leaving the stack
contents undisturbed.
<hr>
<address>
<a href="http://www.sjbaker.org">Steve J. Baker.</a> <<a href="mailto:sjb...@ai...">sjb...@ai...</a>></address>
</body>
</html>
Index: prog_guide.html
===================================================================
RCS file: /cvsroot/plib/plib/doc/psl/prog_guide.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- prog_guide.html 15 Sep 2002 17:45:52 -0000 1.11
+++ prog_guide.html 22 Sep 2002 15:22:21 -0000 1.12
@@ -125,8 +125,6 @@
<ul>
<li> Multiple assignments (eg x = y = 0 ; )
<li> Arrays & Structs.
- <li> Operations on "string" variables.
- <li> String concatenation.
<li> '\' to escape the end-of-line character in strings and macro's.
<li> Array bounds checking.
<li> Parameter passing by name.
@@ -193,6 +191,17 @@
inserted into the byte code to enable the PSL interpreter to
produce debug indicating which lines of the source code are
being traced.
+<H3> Byte-Code Stack Display </H3>
+If you have PSL_TRACE turned on (either via the config variable or
+by the application program), then the shell variable 'PSL_STACK'
+can be set to display the contents of the top eight stack locations
+as the program is traced. If PSL_TRACE is disabled then PSL_STACK
+has no effect.
+<ul>
+<li> <b>never</b> (the default) -- Never produce stack dumps
+ within a trace.
+<li> <b>always</b> -- Always produce a stack dump within trace.
+</ul>
<hr>
<address>
<a href="http://www.sjbaker.org">Steve J. Baker.</a> <<a href="mailto:sjb...@ai...">sjb...@ai...</a>></address>
|
