Club Amiga de Montreal - CAM/CAM_CD_1.iso/files/198.lha/rollback.doc

Text File | 1988-12-27 | 6KB | 132 lines

               ***  Rollback v1.1  ***
        "Still boldly goes where no other program has gone before"


    What Rollback does is simply bring back the information that has
scrolled off the screen on a CLI session.

-------------------------------------------------------------------------

Usage: Run Rollback [number]

This program must be run since it needs the cli window free for cli session.
There is no reason for 'runbackground' it since you don't need to close
the window if this program is running. If there is no cli window, you
don't need this program. When the cli window is closed by 'endcli' this
program will automatically exit so that cli window can be closed. The
catch is that you can't rename 'endcli' to something else since it checks
if endcli command is issued on the session.

[number] is the number of howmany lines it will buffer. The default is
100. If a non-number or number less that 50 is put, it will set the
lines to 50. This is about 2 screenfull of information. I set it to 50
cause I think less than that the buffering will be unuseable.

Keys has been modified to incorporate 500 and 2000 numeric key pad layout.
Keys used (all are in the numeric keypad):
    8 : Scroll up one line [up arrow]
    2 : Scroll down one line [down arrow]
    9 : Scroll up one page [page up]
    3 : Scroll down one page [page down]
    7 : Scroll to the top of buffer [home]
    1 : Scroll to the end of buffer
    5 : Set Cursor current position
    0 : Clear the screen but not clear the buffer.
    . : Clear the buffer
    - : Capture buffer off/on (toggle)

Type 'exit' on the CLI prompt to deactivate Rollback

You CAN RUN another rollback on a DIFFERENT window, however only ONE
rollback per window or it will might GURU.
--------------------------------------------------------------------------
Troubleshootings:


For Conman users:
    Fixed this baby, so it should have any problem with it. Thanks to
    Bill Whawes for some inputs.

You run it, and get 'parent task not found' error message:
    Either the system totally screw up or you run it from a CLI window
    which is spawn by 'CLI' (from WB). Open another CLI window by issuing
    'NewCLI', and run rollback from the NewCLI window.

It runs then the keys doesn't response or keys doesn't response at all:
    Check the priority setting of the CLI. This program has to run at
    higher priority that the CLI so it can intercept the message passing.
    The default priority is 1 higher than the CLI's priority.
    If the CLI's priority is higher, set it to one less this program's
    priority or set this program's priority one higher that CLI.
    Priority setting programs are available on Public Domain.
    Remember some nasty programs will change the cli priority.

You move around the buffer, and the cursor/screen looks screwy:
    Rollback has lose track of the current cursor position which might
    have been alter by other program. This situation might happen if:
    - You turn off the capture do something, and turn it back on again.
    - On conman console you resize the window to min, and resize it back
    - Running program that move cursor around, like 'Conquest' PD game.
    To cure it press '5' which will reset the cursor position,
    if thing is still screwy, you might need to clear the buffer.

Some of the ARP's commands have incompatibilty problem with rollback.
'Assign' and 'Arun' might crash the system when rollback is running.
I don't what these programs do, so right now I recommended for using
the original 'assign' and 'run' commands. Arp's 'status' command and
some PD status programs might not allow rollback to get the data. They
do forbid() while printing out data to the screen. You might what to use
the original status program or better status program.

Please let me know if you have encountered anymore incompatibility problems.
Thanks...



NOTES:

Best to keep the window width at the maximum. It will be handled on the next
version.
Avoid program that outputs lots of control characters to move cursor around
(like Conquest) while Rollback is running. I haven't handled these chars
yet because there are too many combination of them (yack), and will put too
much overhead on the program. I will let you handle this. Nay, I fixed this
problem on this version.
It uses lots of memory for buffering due to the complexity of the console
window control characters, there are colors control codes, movement control
codes etc (see Rom Kernel for detail). I planning to do more efficient
buffering scheme on the next version. Anyway, so if you don't have extra
memory, you might not what to run too many buffer (100 is pretty good I think).
BTW, it works great with 1.3 system.
All and all, enjoy...
----------------------------------------------------------------------------
Rollback v1.1 Copyright 1987 by Andry Rachmat

This PROGRAM is copyrighted and all RIGHTS reserved.
It is a SHAREWARE , therefore PERMISSION is granted to freely
copy, use and redistribute this program, for non-commercial uses, as long
as this program is not altered in any way and is accompanied with this
document.

It is FORBIDDEN to use or include this program on ANY COMMERCIAL
DISK or PRODUCT, without prior, written permission from the author.
If you interested in using this program please contact me at addresses
below.

I make no warranties, either expressed or implied, with respect to the
program described herein, its quality, performance, merchantability,
or fitness for any particular purpose. This program is provided "as is"
and the entire risk as to its quality and performance is with the user.
--------------------------------------------------------------------------
I am planning to do some more works on this.
Your comments are encouraged, let me hear from YOU!

Send comments and contributions (whatever do you think it is worth) to:
    Andry Rachmat (PLINK: A*RACHMAT)
    10715 Roosevelt NE #7
    Seattle, WA 98125
    (206)-367-7485

* December 1th, 1988 *
Merry Christmas and Happy New Year!!