home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 198.lha / rollback.doc < prev    next >
Encoding:
Text File  |  1988-12-28  |  5.8 KB  |  132 lines
  1.                ***  Rollback v1.1  ***
  2.         "Still boldly goes where no other program has gone before"
  3.  
  4.  
  5.     What Rollback does is simply bring back the information that has
  6. scrolled off the screen on a CLI session.
  7.  
  8. -------------------------------------------------------------------------
  9.  
  10. Usage: Run Rollback [number]
  11.  
  12. This program must be run since it needs the cli window free for cli session.
  13. There is no reason for 'runbackground' it since you don't need to close
  14. the window if this program is running. If there is no cli window, you
  15. don't need this program. When the cli window is closed by 'endcli' this
  16. program will automatically exit so that cli window can be closed. The
  17. catch is that you can't rename 'endcli' to something else since it checks
  18. if endcli command is issued on the session.
  19.  
  20. [number] is the number of howmany lines it will buffer. The default is
  21. 100. If a non-number or number less that 50 is put, it will set the
  22. lines to 50. This is about 2 screenfull of information. I set it to 50
  23. cause I think less than that the buffering will be unuseable.
  24.  
  25. Keys has been modified to incorporate 500 and 2000 numeric key pad layout.
  26. Keys used (all are in the numeric keypad):
  27.     8 : Scroll up one line [up arrow]
  28.     2 : Scroll down one line [down arrow]
  29.     9 : Scroll up one page [page up]
  30.     3 : Scroll down one page [page down]
  31.     7 : Scroll to the top of buffer [home]
  32.     1 : Scroll to the end of buffer
  33.     5 : Set Cursor current position
  34.     0 : Clear the screen but not clear the buffer.
  35.     . : Clear the buffer
  36.     - : Capture buffer off/on (toggle)
  37.  
  38. Type 'exit' on the CLI prompt to deactivate Rollback
  39.  
  40. You CAN RUN another rollback on a DIFFERENT window, however only ONE
  41. rollback per window or it will might GURU.
  42. --------------------------------------------------------------------------
  43. Troubleshootings:
  44.  
  45.  
  46. For Conman users:
  47.     Fixed this baby, so it should have any problem with it. Thanks to
  48.     Bill Whawes for some inputs.
  49.  
  50. You run it, and get 'parent task not found' error message:
  51.     Either the system totally screw up or you run it from a CLI window
  52.     which is spawn by 'CLI' (from WB). Open another CLI window by issuing
  53.     'NewCLI', and run rollback from the NewCLI window.
  54.  
  55. It runs then the keys doesn't response or keys doesn't response at all:
  56.     Check the priority setting of the CLI. This program has to run at
  57.     higher priority that the CLI so it can intercept the message passing.
  58.     The default priority is 1 higher than the CLI's priority.
  59.     If the CLI's priority is higher, set it to one less this program's
  60.     priority or set this program's priority one higher that CLI.
  61.     Priority setting programs are available on Public Domain.
  62.     Remember some nasty programs will change the cli priority.
  63.  
  64. You move around the buffer, and the cursor/screen looks screwy:
  65.     Rollback has lose track of the current cursor position which might
  66.     have been alter by other program. This situation might happen if:
  67.     - You turn off the capture do something, and turn it back on again.
  68.     - On conman console you resize the window to min, and resize it back
  69.     - Running program that move cursor around, like 'Conquest' PD game.
  70.     To cure it press '5' which will reset the cursor position,
  71.     if thing is still screwy, you might need to clear the buffer.
  72.  
  73. Some of the ARP's commands have incompatibilty problem with rollback.
  74. 'Assign' and 'Arun' might crash the system when rollback is running.
  75. I don't what these programs do, so right now I recommended for using
  76. the original 'assign' and 'run' commands. Arp's 'status' command and
  77. some PD status programs might not allow rollback to get the data. They
  78. do forbid() while printing out data to the screen. You might what to use
  79. the original status program or better status program.
  80.  
  81. Please let me know if you have encountered anymore incompatibility problems.
  82. Thanks...
  83.  
  84.  
  85.  
  86. NOTES:
  87.  
  88. Best to keep the window width at the maximum. It will be handled on the next
  89. version.
  90. Avoid program that outputs lots of control characters to move cursor around
  91. (like Conquest) while Rollback is running. I haven't handled these chars
  92. yet because there are too many combination of them (yack), and will put too
  93. much overhead on the program. I will let you handle this. Nay, I fixed this
  94. problem on this version.
  95. It uses lots of memory for buffering due to the complexity of the console
  96. window control characters, there are colors control codes, movement control
  97. codes etc (see Rom Kernel for detail). I planning to do more efficient
  98. buffering scheme on the next version. Anyway, so if you don't have extra
  99. memory, you might not what to run too many buffer (100 is pretty good I think).
  100. BTW, it works great with 1.3 system.
  101. All and all, enjoy...
  102. ----------------------------------------------------------------------------
  103. Rollback v1.1 Copyright 1987 by Andry Rachmat
  104.  
  105. This PROGRAM is copyrighted and all RIGHTS reserved.
  106. It is a SHAREWARE , therefore PERMISSION is granted to freely
  107. copy, use and redistribute this program, for non-commercial uses, as long 
  108. as this program is not altered in any way and is accompanied with this 
  109. document.
  110.  
  111. It is FORBIDDEN to use or include this program on ANY COMMERCIAL
  112. DISK or PRODUCT, without prior, written permission from the author.
  113. If you interested in using this program please contact me at addresses 
  114. below.
  115.  
  116. I make no warranties, either expressed or implied, with respect to the
  117. program described herein, its quality, performance, merchantability,
  118. or fitness for any particular purpose. This program is provided "as is"
  119. and the entire risk as to its quality and performance is with the user.
  120. --------------------------------------------------------------------------
  121. I am planning to do some more works on this.
  122. Your comments are encouraged, let me hear from YOU!
  123.  
  124. Send comments and contributions (whatever do you think it is worth) to:
  125.     Andry Rachmat (PLINK: A*RACHMAT)
  126.     10715 Roosevelt NE #7
  127.     Seattle, WA 98125
  128.     (206)-367-7485
  129.  
  130. * December 1th, 1988 *
  131. Merry Christmas and Happy New Year!!
  132.