* VSTK 1.0 for S(X)/G(X)
* A program to display 6, 8 or 10 lines of the stack full screen.
* A Sys-RPL program functionally similar to the User-RPL program
* STKV listed in Jim Donnely's HP48 Hanbook with an added 6 line case.
* Only uses supported entry points.
* Created 03/17/94
* By: Jim Daniels
*
* A modified version of the STK10 program
* Created 01/02/94
* By: John B. Call

This program only uses support entry points and has been tested on both
S(X) and G(X) machines.

This is but another version of a stack viewing program. None really ticked
my fancy until I saw the example User-RPL program STKV in Donnely's HP48
Handbook. I used this as a model when I wrote STK10 for my RLC Series RLC
Circuit Plotter/Solver program. A Sys-RPL version of the STK10 program was
developed by John Call. After making the jump into Sys-RPL programming I
decided to work on this as one of my initial projects. This is an enhanced
Sys-RPL version of the STKV/STK10 program.

VSTK is an expansion of STK10 that will adjust its display mode to match
the depth of the stack. For stack depths of 6 or less the 5x9 font is used,
depths 7 and 8 the 5x7 font is used and a depth of 9 or more uses the 3x7
font. One annoying thing about STKV/STK10 was that the 10th stack line was
out of alignment with the others because of the stack level tag field. When
VSTK displays a 10th level it will prepend stack level fields 1 through 9
with a "0" ( i.e. 01: ). This will keep the contents of of all the stack
levels aligned. When less than 10 levels are displayed the "0" is not
prepended. The program will only display the first 10 items on the stack
and the display does nor scroll. Any object that exceeds the right limit of
the screen is truncated. VSTK will not modify the stack and keystrokes are
not lost. This provides a more versitile stack viewing utility (-| In my
prejudiced opinion |-).

Future enhancements may include a scrolling display with greater depth
capacity. Any other suggestions?

------ RLC Program Users Information ------

VSTK can also be used in place of the STK10 User-RPL program in the RLCDIR
directory. Either STO the VSTK program as STK10 in the RLC directory or STO
it as VSTK and modify the UserRPL "LIST" program to call VSTK. The last two
commands "10 DROPN" needs to be left in the "LIST" subroutine if you want
the stack cleared after a LIST. The Sysy-RPL STK10 did this internally and
required those commands to be deleted. The RLC.S source listing has
appropriate comments in the LIST program to document the required change
using the Sys-RPL STK10 only. You may want to use VSTK all the time and STO
in HOME or wherever in the searched path.


                               Jim Daniels
                               diamond@eskimo.com

