home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / graphuti / riplist1.zip / RIPLIST.DOC < prev    next >
Text File  |  1993-10-17  |  5KB  |  106 lines
  1. RIPList 1.00.1.54 by Steve Fernandez
  2.  
  3. What is RIPList?
  4.  
  5. RIPList is a utility to help debug RIP script file.  It simply outputs a file
  6. that contains the extented text description of the commands in each line and
  7. lists there parameters or arguments.
  8.  
  9. Why RIPList?
  10.  
  11. Well, my Sysop was trying to debug an opening screen for his board and logging
  12. at the cryptic RIP language was giving him a headache.  While were testing the
  13. screen he asked "Why can't someone made a program to list the stuff out so you
  14. can compare it to the screen (acutal display or RIPaint)?"  So I did!  :)
  15.  
  16. Major features of RIPlist include:
  17.     * Support of RIP 1.54 levels 0 & 1 commands (level 9 is not supported)
  18.     * Limited internal viewing program (32k file size limit, I think)
  19.  
  20.                          
  21. System Requirements
  22.  
  23. RIPList is a pretty small program written in Quick BASIC 4.5.  It should work
  24. with 256k of RAM.  A note of caution, this has not been tested.  Also, the
  25. file outputs have been running aprox. x10 the size of the original .RIP file.
  26.  
  27. Legal Stuff
  28.  
  29. RIPList is copyrighted by Steve Fernandez.  The program may not be modified in 
  30. any way except by me, the author.  Please feel free to distribute the 
  31. UNREGISTERED version of the program to any and all BBS's that will allow 
  32. uploads, however all files must be included and there may be no charge for the 
  33. program (this does not include coping fees).
  34.  
  35. All warranties are disclaimed, including damage to hardware and/or software 
  36. from use of this program.  In no event will I be liable for any 
  37. damages, including lost profits, lost savings or other incidental or 
  38. consequential damages arising out of your use or inability to use the 
  39. program, or any other claim by any other party.  
  40.  
  41. RIPList has been heavily beta-tested.  However, due to the complex nature of 
  42. the RIP protocol, not ever situation could be created.  Should a bug or 
  43. program glitch appear please inform me and I shall work to correct it ASAP.
  44.  
  45. Program Usage
  46.  
  47. Currently this version of RIPList is strictly command line.  I want to add a
  48. file requester, but that will have to come at a later time.  I was not aware
  49. of the amount of BIOS calls that are needed under Quick BASIC to preform such
  50. a task.  The syntax is as follows:
  51.  
  52.         RIPLIST filename[.rip] [-t]
  53.  
  54.         The .RIP extention is optional.  The program is smart enough to add it 
  55.         if it finds it missing.  
  56.  
  57.         -t allows an optional terse listing of the rip file.  THIS IS ONLY IN 
  58.            THE REGISTERED VERSION.  This output is similar to the the Object Lister
  59.            function of RIPaint.
  60.  
  61. Registration
  62.  
  63. RIPList is released under the Shareware concept.  The program is not crippled
  64. in anyway.  The file size limit of the viewer is a limitation of the program,
  65. not because it is unregistered.  Beside, if you are viewing a file larger than
  66. what the viewer will handle, you would probably want to use a different viewer
  67. anyway.  There are no time delays or waiting screens or anything of like that.
  68.  
  69. If you choose to register will recieve the registered version of the program.
  70. Registered features include:
  71.         * optional terse listing
  72.         * displays all numbers in normal base 10 rather than base 36
  73.  
  74. Registration is $10 and entitles you to the registered version of the program
  75. and a postcard letting you know of a new release.  Please use the attached
  76. registeration form and mail to this address:
  77.  
  78.         Steve Fernandez
  79.         P.O. BOX 7045
  80.         Denton, Tx 76203
  81.  
  82. A Word from the Author
  83.  
  84. There are a few things I need to let you know about RIPList.  Currently it
  85. does not check for valid parameters, this a feature that is to come.  Also,
  86. at the time of this document writing it does not handle CTRL characters very
  87. well, IE: if you have a ^L in a text line somewhere it will cause the viewer
  88. to eat a few lines of text.  This is being worked but, the since ^L is usually
  89. only used at the start of a RIP scrip file (and the view does handle that ok)
  90. I saving it for the next release or until someone yells that they need now :)
  91.  
  92. Also, in the works is a file requester.  This will take some major programming
  93. time since I didn't know what it took to do this in QB.  Debugging routines,
  94. parameter checking and the like are in the works too.  I am working on these
  95. features, but I welcome any and all user suggestions.  If you do have a 
  96. suggestion, please send it to the address above.
  97.  
  98. LASTER VERSION:
  99. You can always find the latest version of RIPList on CCAT BBS
  100. (512) 242-2206
  101.  
  102. Oh, in case you're wondering about the version numbering scheme:  1.00 is the
  103. current version of RIPList, while 1.54 is the current version of RIP being
  104. supported.  So, a version number of 1.01.1.54 would be version 1.01 of RIPlist
  105. and support version 1.54 of the RIP protocol.
  106.