****************** * PURSIKKA V96.3 * *****Freeware***** INDEX: ------ 1. What is it? 2. What are the requirements? 3. How to use the program 4. Customising CFG file 5. Troubleshooting 6. Revision history & thanks 7. Distribution policy & contacting the author 8. Acknowledgements ************************************************************************* * Note for you people who don't want to read long documents. Copy the * * pursikka.cfg file to C:\DOS\ directory in order to get PURSIKKA work! * ************************************************************************* 1. What is it? -------------- * Note: PURSIKKA was formely known as PURA. The name has changed. PURSIKKA is a program which recognizes the archive from the extension (like .ARJ) and extracts all files from the archive to the directory where you type the command. By using PURSIKKA, you don't have to keep in mind which unpack program you should use (i.e. ARJ or PKUNZIP). You just use PURSIKKA and it takes care of the rest. Thanks to the new feature, .CFG file, PURSIKKA now recognizes any extension specified there, even TXT if you like. See chapter 4 for deatails about the CFG file. PURSIKKA is free software! If you like this program, please copy it to your friends and another places, such as Internet servers and BBSes. Please copy _the ORIGINAL ARCHIVE_ only! Well, OK, if you like it so much, fine. Send me some money. Thanks in advance! 2. What are the system requirements? ------------------------------------ PURSIKKA requires DOS 2.XX or later and the programs it shells to, i.e. ARJ, PKUNZIP and so on. See section 4 for customising PURSIKKA for you. PURSIKKA works fine with Windows 95's Dos shell, too. PURSIKKA also requires PURSIKKA.CFG to be in C:\DOS\ directory. Just copy the file there. Using latest version(s) of unpacking program(s) is recommended. Actually, I'm not exactly sure about that DOS version, it is not tested, because I couldn't find such old version of DOS. At least MS-DOS 5.0 or later should be fine, though. NOTE: PURSIKKA doesn't extract files by itself. It uses other programs to do that. That's why you need the unpacking programs too. 3.How to use the program ------------------------ Note: PURSIKKA's directory must be in the PATH statement as well as unpacking program(s). Type HELP PATH for more details. If you don't know what that PATH is (and don't want to learn either), just copy PURSIKKA AND those unpacking program(s) into your DOS directory (i.e. C:\DOS). That directory should be in the path and probably is. PURSIKKA is easy to use: Step 1. Go to the directory you want to extract the program. Step 2. Type PUR [archive_name] , for example : pur a:\cool.zip You can also type files you want to be extracted, for example : pur a:\cooler.arj readme.txt program.exe would extract readme.txt and program.exe out of a:\cooler.arj. That wasn't too hard, was it? Didn't work? See troubleshooting section (5)! Here's an example for you: (suppose there's a file called WIN.ARJ in C:\MODEM\DOWNLOAD.) C: CD \MODEM\DOWNLOAD MD IN CD IN PUR ..\WIN.ARJ 4. Customising CFG file ----------------------- Pursikka is pre-configured for following extensions: *, arj, a??, a*, a01- a29, zip, lha, lzh and txt. Pursikka can easily be configured for other extensions as well. Read on for instructions how. -The file format of pursikka.cfg file is a plain text file. Two first lines are note lines, which are ignored. DO NOT REMOVE THEM! The third line is the number of lines in the file minus 3. So the number actually is the number of extensions specified, since there is 2 note lines and the number line (3rd line from the beginning). The rest of the lines specify what program PURSIKKA should use for each extension. Put first the extension, then ONE space and the program's running line. You can also specify options too. -Please note that PURSIKKA is case sensitive (cares if letters are small or big), so you have to type each extension two times: arj ARJ x -v ARJ ARJ x -v in order to make PURSIKKA recognize arj and ARJ. If you are an eLiTe guy, you'll also have to specify the other possible extensions you use, like arj, ARJ, aRj, aRJ, Arj... Usually people only use the lower case, so one line is enough for most of you. Decide yourself what suites you best. -Example: --- clips clips --- ;Do not remove these comment lines! Put the number of lines in this file MINUS ;three (3) on the line 3 (next one). Read PURSIKKA.TXT for more details. 3 arj ARJ x -v txt EDIT.COM zip pkunzip -d --- clips clips --- (Of course, the "clips clips" lines don't belong in the CFG file.. ;-) -Note that PURSIKKA doesn't limit the use of it into unpacking programs. Just add them in the correct format to the CFG file, and PURSIKKA can open even .TXT files. To open DOC files with edit, insert two lines in the CFG file: DOC edit.com doc edit.com Don't forget to add the number of these two lines into line three (3)! -Also note, that PURSIKKA itself doesn't harm your system. But be sure what you put in CFG file! If you put there commands like FORMAT C: or so, don't blame me! Tip: If you want to write-protect pursikka.cfg type ATTRIB +R C:\DOS\PURSIKKA.CFG Now no one can change the file until the protection is taken off by typing ATTRIB -R C:\DOS\PURSIKKA.CFG 5.Troubleshooting ----------------- -when I try to use PURSIKKA, I just get an error message "Bad command or file name". *Solution: PURSIKKA's directory is not listed in the PATH statement. That's why DOS can't find it. See Note in section three (3). -PURSIKKA extracts only .ZIP files but not .ARJ files. What's wrong? *Solution: Do you have unpack program for .ARJ files? PURSIKKA doesn't know how to extract files, it just calls other programs to do that. You need a program called ARJ to extract .ARJ kind of files. **Solution #2: If you have ARJ and it still doesn't work: Make sure that also ARJ's directory is listed in PATH. If PURSIKKA works in any directory, but ARJ doesn't, copy ARJ into PURSIKKA's directory. Now PURSIKKA should find also ARJ program. -PURSIKKA won't extract anything. It just flashes on the screen and returns to the DOS prompt. What's wrong? *Solution: Make sure that you have the pursikka.cfg in C:\DOS\ directory. If PURSIKKA can't find it there, it displays an error message: "Error 53 at pgm-ctr:111". This message only flashes on the screen, so it may be hard to notice it. -I'm a Windows 95 user and don't have C:\DOS\ directory at all. What should I do? *Solution: Make the directory and then copy pursikka.cfg there. See DOS help for more details. -If pura does something weird, first check that your .cfg file is OK. If you still have problems, first read this file carefully. If you still can't solve your problem, just contact me, I'll try to check what's wrong. If you contact by mail, send a couple of bucks too, so that I can send the reply letter to you. If the returning of the letter costs more money than you have included, the letter will not be returned. After all, this is free software. E-mail is the handiest & fastest way, USE IT! Also tell all things about your computer, like brand, processor etc. etc. For contact information, see section seven (7). 6.Revision history & thanks --------------------------- (Format of dates is: dd.mm.yyyy.) PURSIKKA 96.3 - Second public release 5.6.1996. - CFG file - now PURSIKKA supports ALL extensions! - Docs updated again. - Contact information updated (e-mail and www added). [--[ Here the name was changed to PURSIKKA, because PURA was already in ]--] [--[ use by Heikki Kultala. ]--] Pura 96.2 - First public release 17.3.1996. - Docs updated. - Finally decided to release it. Pura 96.1 - Beta release 3.3.1996. -LHA support fixed. Now supports .LZH and .LHA. Pura 96.0 - Non-public release 21.2.1996. -Few bugs fixed.. -Troubleshooting added to docs. Not so big section, but I hope someone finds it useful. Pura 0.95 Beta - Non-public release 26.12.1995. -Support added for .A??, .A* and .* extensions. -Docs included. Pura 0.9 Beta - Non-public release 5.12.1995. Support for .ARJ, .ZIP and .LHA files. Thanks to: - - - - - -Beta testers: Aku Faarinen, Niklas Westerstr†hle. -Robert Jung for developing the ARJ program. I think your program is simply the best! -IBM for developing PC's. -Advanced Gravis for GUS. -You, that's right, for downloading this file. Please distribute it to your friends and Bulleting Board Systems (BBS). Don't change anything in the packet, distribute the original one only! 7.Distribution policy & contacting the author --------------------------------------------- OSKARI OJALA PROVIDES PURSIKKA "AS IS" AND WITHOUT WARRANTY OF ANY KIND. THE PROGRAM IS FREEWARE AND YOU MAY USE IT FREE OF CHARGE. YOU ARE ALLOWED TO DISTRIBUTE THE ORIGINAL ARCHIVE FREELY. NO PAYMENT OF ANY KIND MAY ==================== BE CHARGED FOR THIS PRODUCT WITHOUT OSKARI OJALA'S AUTHORIZATION AND OFFICIAL WRITTEN LICENSE. OSKARI OJALA SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE USE OF THIS SOFTWARE. IF A COMPANY OR A MAGAZINE, WHICH PUBLISHES PD/SW SOFTWARE ON CD-ROM, FLOPPIES OR ON SOME OTHER MEDIA, WISHES TO INCLUDE PURSIKKA IN THEIR PUBLICATION, THEY MUST SEND ME ONE COPY OF THE CD-ROM/FLOPPY THEY ARE PUBLISHING. (phew!) So I am not responsible for anything at all. Nothing. To contact the author, use one of the following methods: -Normal mail: Oskari Ojala Visam„ki 3 D 24 01230 Espoo Finland -E-mail: Okko@mtv3.fi -WWW page: http://www.mikrobitti.fi/ojala/index.htm I'm also known as Solid Blue. I'm in a group called Dark Legion. It's possible you see me on IRC, the alias you should be looking for is S-Blue. If you have some good ideas, I'll be happy to hear about them. I won't add lots of options, since the ideas of this software are words easy and fast. So mouse support, windows stuff, or pull-down menus are NOT coming up. But all ideas are welcomed anyway! * * * You are _very_ welcome to send me post cards! * * * You can also reach me in MBnet, Finlands biggest BBS. 8. ACKNOWLEDGEMENTS: -------------------- ARJ Copyright (c) 1990-95 ARJ Software. LHARC is the name of an archiver by Haruyasu Yoshizaki. PKZIP and ZIP are trademarks of PKWare, Inc. Other product and company names are trademarks of their respective owners. - - - Thank YOU, whoever you are, if you just read all this...