[v1.40] SlipKnot - WWW browser w/o SLIP Developed for PC Windows users with UNIX shell accounts, SlipKnot is a full featured graphical World Wide Web browser similar to Mosaic and Netscape, allowing local document display offline, saving of documents, and includes FTP and Gopher. Shareware (US$29.95 -MC/Visa/AMEX/check/MO) Peter Brooks, slpstaff@micromind.com Welcome to SlipKnot's installation guide. Contents: 1. Quick Description 2. System and Host requirements 3. Installation Steps 4. For more SlipKnot information 5. Note from the author ====== 1. A quick description of SlipKnot: ============================ 1. SlipKnot is a graphical World-Wide-Web browser for PC users running Windows 3.1+ or a higher level of Windows. 2. It is designed for modem users with ordinary dial-up UNIX shell accounts. 3. It does NOT require SLIP or PPP or TCP/IP services in any form (no TIA or remosock, etc. if you are familiar with these products). ====== 2. Computer and UNIX service provider requirements =============== On your computer: 1. Windows 3.1, Windows for Workgroups or higher, Windows NT, running in 386 Enhanced Mode (SlipKnot cannot be used on 286 processors) or Windows 95, or OS/2-Win. 2. At least 4 MB of memory, recommended 8MB. We have noticed memory deficiency errors at 4 MB. 3. At least 2 MB of available hard disk space. SlipKnot itself takes approx. 1.5 MB. When working, SlipKnot's job will be to download documents for you from the Internet, and these may require plenty of hard disk space. 4. Mouse or other pointing device required (cannot control SlipKnot via only the keyboard). On your service provider's UNIX host: 1. Your UNIX system must have either the program "lynx" (version 2.2 or later, preferably 2-4-2 or 2.4-FM) or the program "www" available. If in doubt, log in to your host, and try to execute either of these programs. You will then know immediately whether they are available. To find the version of lynx on your UNIX host, execute the UNIX command: "lynx -version". 2. Your UNIX host must have a program to send files to you via either the Xmodem, Ymodem, Zmodem or Kermit protocol. The actual name of the programs that perform these file transfers changes from system to system, but try the commands "sx" (for XModem), "sb" (for YModem), "sz" (for Zmodem) or "kermit" (for Kermit). If these fail, ask your system administrator or some other knowledgeable person. Likewise, you will need to know the name of the UNIX program that will receive files from your PC using Xmodem, Ymodem, Zmodem or Kermit. 3. Your UNIX system must be able to display individual file sizes using the "ls -l filename" command. If "ls" has been renamed or works differently from normal, SlipKnot will fail. ========= 3. Steps to installing it ===================================== 1. Assuming that you have unzipped the SlipKnot distribution file into a temporary directory (please DO NOT choose the temporary directory (often \TMP) that Windows uses for its termporary files), launch Windows (Enhanced 386 Mode only), bring up File/Run in the Program Manager: C:\temporary-directory\SETUP. This will install SlipKnot and create a new Windows group. 1.1 IMPORTANT: If you receive a message from SETUP indicating that the file "DDEML..." is in use, you may safely ignore this message and proceed. 1.2 IMPORTANT: If you receive a message from SETUP that it was unable to install the file "THREED.VBX" then you may have two options: 1) ignore the message (if it is not fatal), which you will be allowed to do if there is a version difference between your existing C:\WINDOWS\SYSTEM\THREE.VBX file and the one that SlipKnot is attempting to install; or 2) follow the instructions below carefully... NOTE: This message is due to a bug in Microsoft's SETUP program. For the sake of the instructions below, we'll assume that the directory you specified for SlipKnot is "C:\SLIPKNOT". In the instructions below, substitute the appropriate directory on your own system. a) Terminate SlipKnot (Pressing OK to the error message will probably terminate SlipKnot SETUP anyway). b) Using DOS or any other file manager, get into your \WINDOWS\SYSTEM directory. c) You should find the file: "THREED.VBX" there. Rename it to: "THREED.BAK" d) Get into your SlipKnot directory (say, C:\SLIPKNOT). Delete all the files there. e) Now start the SETUP process again. f) If it fails again, please contact MicroMind at: slpstaff@micromind.com 1.3 If you get a message about being unable to write or load the COMMDLG.DLL file: it is safe to ignore this message. 2. Press the ReadMe Icon from the SlipKnot Windows group. There may be last minute information there. 3. Launch SlipKnot. 4. You will be in SlipKnot Terminal and will have to configure the communications options, Terminal fonts (make sure you choose a terminal font small enough that the entire Terminal Window fits onto your screen and large enough to be comfortable), and Host options. Bring up Windows Help and keep it visible as a guide to the meanings of the options (this is important!). 5. Try to connect to your host, to test your login script, if you have chosen to use login scripts (rather than manual login). We suggest that you use "manual login" the first time until you are familiar with SlipKnot's operations (this setting is in the menu item: Setup/Host). 6. Once connected, try downloading a small file from your Host as a test. The download option is available under the Communications menu item. 6a. If your download attempts fail (with a message like: "Unable to write to your Host"), the problem may be that your shell has the "noclobber" option set. Check SlipKnot Help concerning this problem. 7. If downloading works, press the World Wide Web button, while at your UNIX prompt. This will launch a one-time process to deposit a couple of short shell scripts onto your host. This occasionally fails. If it does fail, try again, or use the Initialize Host menu item under Setup. If it fails repeatedly, send us email (address at end) and we will try to debug this. On the other hand, if it succeeds, you will not have to go through this again (at least until you upgrade). 8. You are now in SlipKnot's Web renderer, with SlipKnot's Home Page visible. 9. Explore Configure options; check out the SlipKnot What's New Page, etc. 10. Remember that retrieving documents from the Internet can be tricky for many reasons, not the least of which is that there is heavy traffic out there that can cause any retrieval to fail (SlipKnot normally retries in case of failure). Please send us a message when you have loaded SlipKnot -- we would like to know who has actually tried it. Also, send bug reports, comments, fan mail, etc. to slpstaff@micromind.com Good luck, happy browsing, and thanks in advance for your efforts. ========= 4. More Information on/about SlipKnot =================== Internet resources: If you already have a WWW browser (lynx is fine)... SlipKnot's Home Page is at: http://plaza.interport.net/slipknot/slipknot.html SlipKnot's What's New Page, announcing new versions is at: http://plaza.interport.net/slipknot/whatsnew.html --------------- The FAQ file: SlipKnot's FAQ file already inside this distribution .ZIP file, and will be available to you when you have uncompressed it (this will be done automatically when you run the SETUP program). It is in the file: SNTFAQ1.TXT in your SlipKnot directory. If you have not been able to run the SETUP program, you can expand the FAQ file manually: find the SNTFAQ1.TX_ file and run the DOS program: EXPAND SNTFAQ1.TX_ SNTFAQ1.TXT Alternatively, you can download the FAQ file from the internet. It can be retrieved from: ftp://interport.net/pub/pbrooks/slipknot/sntfaq1.txt ------------- Tech support: We provide technical support via the Internet. Our tech support email address is: slpstaff@micromind.com We also monitor and contribute to discussions of SlipKnot on the newsgroup: comp.infosystems.www.browsers.ms-windows =========== 4. Note from Peter Brooks ==================================== SlipKnot was created because, at that time, there was no other alternative to accessing the World Wide Web graphically if you did not have SLIP or PPP or TCP/IP access. Having analyzed Mosaic and some of its competitors, I concluded that all of these browsers were designed for people with very rapid communications channels into the Internet, not modem users. Even if you have SLIP access, most of these browsers do not allow you to save entire documents (with the included pictures), forcing you to retrieve the documents again whenever you wish to take a full look at them. It takes a while to retrieve any document by modem with any browser, and you shouldn't have to do this more than once. The Wold Wide Web is a truly wonderful human construct to explore. I hope that SlipKnot will make the Web accessible for the first time to a very large number of people, who will take as much delight in it as I have. Peter Brooks, SlipKnot developer MicroMind, Inc. slpstaff@micromind.com