README for Thinkage YAY Contents -------- *About Thinkage YAY *Installation *Distribution, copyright *Registration *Bug Reports *Contact information 1. About Thinkage YAY YAY, which stands for Yet Another YACC, is a package that generates software to parse text input. YAY lets you describe the grammar of the input language you want to parse and uses this grammar to generate the parser software. In addition to the usual YACC facilities, YAY supports LR(2) grammars (with two levels of lookahead), and provides special "preference" constructs that give you more control over resolving ambiguities. This package runs on Linux, SunOS, Windows NT, DOS and OS/2 platforms. 2. Installation See the end of this section for system-specific instructions. To unpack YAY 1.0, run one of the following commands depending on which archive you have: For yay-1.0.tar.Z (compressed tar file on SunOS): zcat yay-1.0.tar.Z | tar xvf - For yay-1.0.tar.gz (Gnu-zipped tar file on SunOS and Linux): zcat yay-1.0.tar.gz | tar xvf - For yay-1_0.zip (zipped file on DOS, OS/2 and Windows NT): unzip yay-1_0.zip This operation unpacks everything into a directory called 'yay-1.0' on SunOS and Linux, and 'yay-1_0' on OS/2, DOS and NT. To install YAY, change to this directory and run the 'setup' program. The setup program will ask you where to put the various YAY-related files. It will also create an installation file that tells YAY where to find the files it needs. If you don't use the default filename for the installation file, you must set the YAY_INST environment variable to be the name of the installation file. Alternately, you can use YAY's INSTallation= command-line option. After setup finishes, you can look at the setup.log file to see what it did. Finally, you should copy the 'yay' executable file to a directory that is in your search path. 2.1 SunOS-Specific Instructions SunOS users should download either the .Z file or the .gz file. The .gz file is smaller, but you will need the gzip package to unpack it. You can downloand the README from ftp://prep.ai.mit.edu/pub/gnu/README-about-.gz-files. Gzip source can be found at ftp://prep.ai.mit.edu/pub/gnu/gzip-1.2.4.tar. 2.2 OS/2-Specific Instructions OS/2 users can get unzip from . Create a new directory and run unz512x2.exe from within it. This will create a number of files including README and unzip.exe. See the README for further information. Using PKZIP for OS/2 is not recommended. 2.3 Windows NT-Specific Instructions Windows NT users can get unzip from . Create a new directory and run unz512xn.exe from within it. This will create a number of files including README and unzip.exe. See the README for further information. Using PKZIP for NT is not recommended. 2.4 DOS-Specific Instructions: DOS users can get unzip from . Create a new directory and run unz512x3.exe from within it. This will create a number of files including README and unzip.exe. See the README for further information. Using PKZIP for DOS is not recommended. DOS users require the DOS4GW.EXE 32-bit extender which is included in the distribution under the DOS4GW directory. This must be installed before installing YAY. See the file DOS4GW.DOC for installation and configuration instructions. Normally, you only need to copy DOS4GW.EXE to a directory that is in your search path, but the documentation explains settings that you may need if you have unusual hardware or if you do not like the defaults. 2.5 Removal Change to a directory that was NOT created during the installation procedure (such as your home directory or the root directory). Run the 'uninst' program using the full name of the command. You will be prompted for a log file name. This file will be used to log errors and list all files and directories that are removed. By default this information will be printed to your display. After uninst finishes, you can look at the log file to see what uninst did. If uninst cannot find the installation file, it will ask you where it is. It will then remove all the files that the setup program installed. If you have installed yay more than once on the same system you must be careful to uninstall the correct one. The safest way to do this is to use the INSTallation= option: /usr/local/lib/yay-1.0/uninst INST=/usr/local/lib/yay-1.0/instinfo or on OS/2, DOS or Windows NT: C:\thinkage\yay-1_0\uninst INST=C:\thinkage\yay-1_0\instinfo Those examples reflect the default values for the INSTallation= option. You would not need to use the INSTallation option in those cases unless the YAY_INST variable was set. If YAY was installed on OS/2, DOS or NT in D:\yay-1.0 then you might use D:\yay-1.0\uninst INST=D:\yay-1.0\instinfo Un-installation is slightly different on OS/2. The OS/2 version of uninst will usually report that it was unable to delete some of its files (such as uninst.exe). This occurs because OS/2 will not allow files to be deleted if they are in use. Usually uninst can delete these files after the uninst program is finished. You should check that these files were deleted. You do not need to reboot after running uninst. 2.6 Documentation Documentation is provided in both text and postscript versions. You can find the postscript versions of the full manual and the YAY command-syntax help in the following files: SunOS and Linux: yay-1.0-manual.ps yay-1.0-help.ps DOS, OS/2 and Windows NT: yay10man.ps yay10hlp.ps 3. Distribution, copyright For purposes of this section, the term "User" is defined as anyone trying out the Program and/or a registered licensee of the Program. This software is protected by both Canadian Copyright Law and International Treaty provisions. Therefore you must treat this software just like a book with the following single exception. Thinkage Ltd. authorizes you to make archival copies of the software for the sole purpose of backing up your software and protecting your investment from loss. By saying, "just like a book", Thinkage means, for example, that this software may be used by any number of people and may be freely moved from one location to another so long as there is no possibility of it being used at one location while it is being used at another. In the same way that two different people in two different places cannot read the same book at the same time, neither may the software be used by two different people in two different places at the same time, without violating Thinkage's copyright. Thinkage warrants that it has title to the Programs free of any lien, charge, encumbrance or claim. Title to the programs and any materials associated therewith shall at all times remain in Thinkage. Thinkage makes no representation with respect to the adequacy of these Programs for any particular purpose, or with respect to their adequacy to produce any particular result. The User agrees to absolve Thinkage of any responsibility for losses, costs, damages, or expenses of every nature or kind due to use of the Programs. If the User finds the programs unsatisfactory in any way, the User's sole recourse is to request a refund of moneys already paid to Thinkage. In this case, Thinkage will return this amount to the User in a timely manner. When the money has been returned, the User will destroy all of its copies of the programs and any products derived from the programs, and will cease to use the programs in any way. 4. Registration Registration form for Thinkage Ltd. shareware Name: Company Name (if applicable): Address: City: Province/State: Country: Postal Code/Zip Code: Phone: Fax: Email: Software Registering: ___ Thinkage YAY, Version 1.0 @ $50US per copy Total: $ (Payment methods accepted: cheques or money orders made payable to: Thinkage Ltd.) (All applicable taxes included.) Would you like us to notify you of upgrades to your software?: Would you like us to notify you of new products from Thinkage?: The following section is optional. We have included it to speed up bug fixes and to get an idea of what systems people are using our software on. System Hardware: Operating System: Mail your registration to Shareware Thinkage Ltd. 85 McIntyre Drive Kitchener, Ontario Canada N2R 1H6 Fax: 519-895-1864 Email: shareware@thinkage.on.ca 5. Bug Reports Please contact us with a description of any bugs you find, with as much detail as possible regarding the system and circumstances of the error. 6. Contact Information Email: shareware@thinkage.on.ca Phone: 519-895-1860 Fax: 519-895-1864 Mail: Thinkage Ltd. 85 McIntyre Drive Kitchener, Ontario Canada N2R 1H6