home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / PROGRAMS / WSTAR / RESQ17.LBR / RESQ17.DQC / RESQ17.DOC
Text File  |  2000-06-30  |  4KB  |  74 lines
  1.                         **>>  RESQ v1.7 <<**
  2.  
  3. RESQ saves buffered text, left in your computer's RAM before it was
  4. written to disk.  If you've ever lost text due to a WordStar "disk
  5. full" glitch, or forgotten to save that text file you just downloaded,
  6. or frozen your console while testing a new program, or given the wrong
  7. answer to "Abandon current version?", you can use RESQ.  Version 1.7
  8. has a variety of changes in its algorithm which make it easier to use
  9. and more accurate than the earlier released version, RESQ15.
  10.  
  11.                                 RESQ
  12.  
  13.      *>  dynamically finds the limits of computer memory (the TPA)
  14.      *>  hunts between those limits for a text phrase you supply
  15.      *>  shows you the text in the area of the new-found phrase
  16.      *>  asks "Is this your file?"
  17.      *>  if you agree, finds the beginning of the text
  18.      *>  shows and saves the text in RES.Q on your logged drive
  19.      *>  closes the rescued file when you hit any key, or
  20.      *>  when it finds the end-of-file character (^Z)
  21.  
  22. RESQ searches its own version of RAM with all high bits reset. Thus it
  23. finds text made by WordStar as easily as ASCII text. It is unecessary
  24. for you to remember the text which begins your semi-lost file. Just
  25. give RESQ a phrase of up to 55 characters anywhere in the text, and it
  26. will usually be able to get back to the head of the text before
  27. beginning to save. If not, try another phrase which may come earlier
  28. in the file. Occasionally, with simple phrases, there will be another
  29. copy in RAM which is not in your file.  If what RESQ shows you (when
  30. it asks: Is this your file?) is junk, or an accidental match to your
  31. phrase, just answer "No" and RESQ will continue to hunt.  
  32.  
  33. Search phrases should be entered exactly as they occur; capitalization
  34. and line breaks matter.  On the other hand, a single word is likely to
  35. be unique in RAM, so a single well-chosen word will usually guide the
  36. search successfully.
  37.  
  38. If you wish to stop a phrase search, type ^S while search addresses are
  39. rolling, then type ^C to exit to CP/M.
  40.  
  41. RESQ works for any program which buffers regular text above the point
  42. where RESQ itself leaves off, at about 2960h. For example, RESQ finds
  43. text left in RAM by WordStar 2.26, WordStar 3.0, WordStar 3.3, Mex,
  44. and the Turbo Pascal editor equally well. The search is unaffected if
  45. you must reset (cold boot) in order to revive your console before
  46. using RESQ to find your text.
  47.  
  48. RESQ cannot recover all text.  Some programs which handle text do not
  49. store it in RAM, intact in a buffer, and in these cases, RESQ will
  50. sign off, reporting the range of addresses searched unsucessfully. 
  51. Another occasional cause of wierd results is that some programs (eg,
  52. VDO and VDE) buffer their text in an encoded form which differs from
  53. the onscreen version.  In that case, the best that RESQ can do is find
  54. and save the encoded text by seeking a word which is not encoded.
  55.  
  56. Though it uses a different algorithm, RESQ was inspired by Chris and
  57. Steve Rudek's MAGE, which is a Public Domain "saver" directed only at
  58. the address of the WordStar text buffer.  RESQ was written for CP/M 2.2
  59. and uses Z80 operations.  Because it searches from its own top to an
  60. address which is determined from the structure of your computer's RAM
  61. at the moment RESQ is invoked, it will probably work without adjustment
  62. on most CP/M systems, and for most text-handling programs.
  63.  
  64. Good luck; but you'll need less luck if you have RESQ.
  65.  
  66.  
  67. January, 1986                                Mike Yarus
  68.                                              2231 16th Street
  69.                                              Boulder, CO 80302
  70.  
  71.                                              Compuserve 73145,513
  72.                                        Boulder, CO 80302
  73.  
  74.