home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / yay-1_0.zip / yay-1_0 / README next >
Text File  |  1996-02-06  |  8KB  |  250 lines
  1. README for Thinkage YAY
  2.  
  3. Contents
  4. --------
  5. *About Thinkage YAY
  6. *Installation
  7. *Distribution, copyright
  8. *Registration
  9. *Bug Reports
  10. *Contact information
  11.  
  12. 1. About Thinkage YAY
  13.  
  14. YAY, which stands for Yet Another YACC, is a package that generates
  15. software to parse text input.  YAY lets you describe the grammar of
  16. the input language you want to parse and uses this grammar to generate
  17. the parser software.  In addition to the usual YACC facilities, YAY
  18. supports LR(2) grammars (with two levels of lookahead), and provides
  19. special "preference" constructs that give you more control over
  20. resolving ambiguities.
  21.  
  22. This package runs on Linux, SunOS, Windows NT, DOS and OS/2 platforms.
  23.  
  24. 2. Installation
  25.  
  26. See the end of this section for system-specific instructions.
  27.  
  28. To unpack YAY 1.0, run one of the following commands depending on
  29. which archive you have:
  30.  
  31. For yay-1.0.tar.Z (compressed tar file on SunOS):
  32.     zcat yay-1.0.tar.Z | tar xvf -
  33.  
  34. For yay-1.0.tar.gz (Gnu-zipped tar file on SunOS and Linux):
  35.     zcat yay-1.0.tar.gz | tar xvf - 
  36.  
  37. For yay-1_0.zip (zipped file on DOS, OS/2 and Windows NT):
  38.     unzip yay-1_0.zip
  39.  
  40. This operation unpacks everything into a directory called 'yay-1.0' on
  41. SunOS and Linux, and 'yay-1_0' on OS/2, DOS and NT.  To install YAY,
  42. change to this directory and run the 'setup' program.
  43.  
  44. The setup program will ask you where to put the various YAY-related
  45. files.  It will also create an installation file that tells YAY where
  46. to find the files it needs.  If you don't use the default filename for
  47. the installation file, you must set the YAY_INST environment variable
  48. to be the name of the installation file.  Alternately, you can use
  49. YAY's INSTallation= command-line option.
  50.  
  51. After setup finishes, you can look at the setup.log file to see what
  52. it did.
  53.  
  54. Finally, you should copy the 'yay' executable file to a directory that
  55. is in your search path.
  56.  
  57. 2.1 OS/2-Specific Instructions
  58.  
  59. OS/2 users can get unzip from
  60. <ftp://ftp.cdrom.com/pub/os2/archiver/unz512x2.exe>.  Create a new
  61. directory and run unz512x2.exe from within it.  This will create a
  62. number of files including README and unzip.exe.  See the README for
  63. further information.  Using PKZIP for OS/2 is not recommended.
  64.  
  65. 2.2 SunOS-Specific Instructions
  66.  
  67. SunOS users will need gzip.  You can downloand the README from 
  68. ftp://prep.ai.mit.edu/pub/gnu/README-about-.gz-files.  Gzip source
  69. can be found at ftp://prep.ai.mit.edu/pub/gnu/gzip-1.2.4.tar.
  70.  
  71. 2.3 DOS-Specific Instructions:
  72.  
  73. DOS users require the DOS4GW.EXE 32-bit extender which is included in
  74. the distribution under the DOS4GW directory.  This must be installed
  75. before installing YAY.  See the file DOS4GW.DOC for installation and
  76. configuration instructions.  Normally, you only need to copy
  77. DOS4GW.EXE to a directory that is in your search path, but the
  78. documentation explains settings that you may need if you have unusual
  79. hardware or if you do not like the defaults.
  80.  
  81. 2.4 Removal
  82.  
  83. Change to a directory that was NOT created during the installation
  84. procedure (such as your home directory or the root directory).
  85. Run the 'uninst' program using the full name of the command.
  86. You will be prompted for a log file name.  This file will be used
  87. to log errors and list all files and directories that are removed.
  88. By default this information will be printed to your display.
  89. After uninst finishes, you can look at the log file to see what
  90. uninst did.
  91.  
  92. If uninst cannot find the installation file, it will ask you
  93. where it is.  It will then remove all the files that the setup
  94. program installed.  If you have installed yay more than once on
  95. the same system you must be careful to uninstall the correct one.
  96. The safest way to do this is to use the INSTallation= option:
  97.  
  98.    /usr/local/lib/yay-1.0/uninst INST=/usr/local/lib/yay-1.0/instinfo
  99.  
  100. or on OS/2, DOS or Windows NT:
  101.  
  102.    C:\thinkage\yay-1_0\uninst INST=C:\thinkage\yay-1_0\instinfo
  103.  
  104. Those examples reflect the default values for the INSTallation=
  105. option.  You would not need to use the INSTallation option in those
  106. cases unless the YAY_INST variable was set.  If YAY was installed on
  107. OS/2, DOS or NT in D:\yay-1.0 then you might use
  108.  
  109.    D:\yay-1.0\uninst INST=D:\yay-1.0\instinfo
  110.  
  111. Un-installation is slightly different on OS/2.  The OS/2 version of
  112. uninst will usually report that it was unable to delete some of its
  113. files (such as uninst.exe).  This occurs because OS/2 will not allow
  114. files to be deleted if they are in use.  Usually uninst can delete
  115. these files after the uninst program is finished.  You should check
  116. that these files were deleted.  You do not need to reboot after
  117. running uninst.
  118.  
  119. 2.5 Documentation
  120.  
  121. Documentation is provided in both text and postscript versions.  You
  122. can find the postscript versions of the full manual and the YAY
  123. command-syntax help in the following files:
  124.  
  125. SunOS and Linux:
  126.     yay-1.0-manual.ps
  127.     yay-1.0-help.ps
  128.  
  129. DOS, OS/2 and Windows NT:
  130.     yay10man.ps
  131.     yay10hlp.ps
  132.  
  133.  
  134. 3. Distribution, copyright
  135.  
  136. For purposes of this section, the term "User" is defined as anyone 
  137. trying out the Program and/or a registered licensee of the Program.
  138.  
  139. This software is protected by both Canadian Copyright Law and International
  140. Treaty provisions.  Therefore you must treat this software just like a book
  141. with the following single exception.  Thinkage Ltd. authorizes you to make
  142. archival copies of the software for the sole purpose of backing up 
  143. your software and protecting your investment from loss.
  144.  
  145. By saying, "just like a book", Thinkage means, for example, that this software
  146. may be used by any number of people and may be freely moved from one
  147. location to another so long as there is no possibility of it being used
  148. at one location while it is being used at another.  In the same way 
  149. that two different people in two different places cannot read the same
  150. book at the same time, neither may the software be used by two different
  151. people in two different places at the same time, without violating 
  152. Thinkage's copyright.
  153.  
  154. Thinkage warrants that it has title to the Programs free of any lien,
  155. charge, encumbrance or claim.  Title to the programs and any materials 
  156. associated therewith shall at all times remain in Thinkage.
  157.  
  158. Thinkage makes no representation with respect to the adequacy of these
  159. Programs for any particular purpose, or with respect to their adequacy
  160. to produce any particular result.
  161.  
  162. The User agrees to absolve Thinkage of any responsibility for 
  163. losses, costs, damages, or expenses of every nature or kind due to 
  164. use of the Programs.
  165.  
  166. If the User finds the programs unsatisfactory in any way, the User's
  167. sole recourse is to request a refund of moneys already paid to Thinkage.
  168. In this case, Thinkage will return this amount to the User in
  169. a timely manner.  When the money has been returned, the User will
  170. destroy all of its copies of the programs and any products derived 
  171. from the programs, and will cease to use the programs in any way.
  172.  
  173. 4. Registration
  174.  
  175. Registration form for Thinkage Ltd. shareware
  176.  
  177. Name:
  178.  
  179. Company Name (if applicable):
  180.  
  181. Address:
  182.  
  183. City:
  184.  
  185. Province/State:
  186.  
  187. Country:
  188.  
  189. Postal Code/Zip Code:
  190.  
  191. Phone:
  192.  
  193. Fax:
  194.  
  195. Email:
  196.  
  197. Software Registering:
  198.  
  199.    ___    Thinkage YAY, Version 1.0 @ $50US per copy
  200.  
  201.  
  202.     Total:    $
  203.     (Payment methods accepted:  cheques or money orders made 
  204.     payable to:  Thinkage Ltd.)
  205.  
  206. (All applicable taxes included.)
  207.  
  208. Would you like us to notify you of upgrades to your software?:
  209.  
  210. Would you like us to notify you of new products from Thinkage?:
  211.  
  212. The following section is optional.  We have included it to speed up
  213. bug fixes and to get an idea of what systems people are using our software
  214. on.
  215.  
  216. System Hardware:
  217.  
  218.  
  219. Operating System:
  220.  
  221.  
  222.  
  223.  
  224. Mail your registration to 
  225. Shareware
  226. Thinkage Ltd.
  227. 85 McIntyre Drive
  228. Kitchener, Ontario
  229. Canada  N2R 1H6
  230.  
  231. Fax: 519-895-1864
  232.  
  233. Email: shareware@thinkage.on.ca
  234.  
  235. 5. Bug Reports
  236.  
  237. Please contact us with a description of any bugs you find, with as much
  238. detail as possible regarding the system and circumstances of the error.
  239.  
  240. 6. Contact Information
  241. Email: shareware@thinkage.on.ca
  242. Phone:  519-895-1860
  243. Fax: 519-895-1864
  244. Mail:
  245. Thinkage Ltd.
  246. 85 McIntyre Drive
  247. Kitchener, Ontario
  248. Canada  N2R 1H6
  249.  
  250.