home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / MRFiles / GWPATCH.SFX / gwpatchdocs.cvt (.txt) < prev    next >
Encoding:
GEOS ConVerT  |  1990-02-12  |  10.0 KB  |  55 lines
  1. gwPatchDocs
  2. PRG formatted GEOS file V1.0
  3. CONVERTED WITH GEOSHELL V2.2
  4. Write Image V2.1
  5. geoWrite    V2.1
  6. .Use CourierNLQ font. Allows printing in NLQ mode with your printer's own font.
  7. G@gateWayPatch Documentation
  8. by Maurice Randall
  9. gateWayPatch is Copyright 1996 by Maurice Randall.
  10. gateWay 64 and gateWay 128 were written by Paul Bosacki and later upgraded by Jim Collette and is copyrighted by Creative Micro Designs.
  11. geoFAX is written and copyrighted by Maurice Randall
  12. geoSHELL is written and copyrighted by Maurice Randall
  13. GEOS 64 and GEOS 128 is copyrighted by GeoWorks and distributed by Creative Micro Designs.
  14. G@THE PURPOSE OF THIS PATCH
  15. This patch works with all versions of gateWay from the early versions on up to the latest ones. It works with both the 64 and the 128 version.
  16. The patch will fix the main portion of gateWay to prevent crashing when displaying unknown filetypes in the directory listing on the screen. The unknown filetypes will appear as "SYSTEM" files. This patch does not fix "BigInfo". BigInfo has the same sort of problem as is found within the main part of gateWay. You will have to avoid using BigInfo with unknown filetypes.
  17. G@WHO MAY NEED THIS
  18. The people that need this patch the most are geoFAX owners that use gateWay. Even people that do not have geoFAX should use this patch since it fixes a very important bug in gateWay that might show up with other applications later on. gateWay gets corrupted and in most cases will crash when it encounters a geoFAX printer driver in the directory listing.
  19. G@DISTRIBUTION
  20. This patch program may be freely distributed by any means so that as many owners of gateWay can have access to it. It's actual use should be restricted only to registered owners of gateWay.
  21. G@A LITTLE BACKGROUND
  22. At the time that gateWay was written, there were only a certain number of GEOS filetypes in use. And so, there we
  23. G@A LITTLE BACKGROUND
  24. At the time that gateWay was written, there were only a certain number of GEOS filetypes in use. And so, there were no problems related to using gateWay with any filetype. A GEOS filetype refers to the type of file, such as an application, a data file, a desk accessory, a printer driver, etc. Each of these different filetypes are represented by a number and that number is located right in the directory entry for each file on the disk. A directory entry consists of 30 bytes altogether including the filename, the location of the starting block, the location for the header block, the creation date and time, the filesize, and the filetype.
  25. Here's where gateWay gets in trouble with certain filetypes. GEOS allows filetype numbers to be between 0 and 99. The original filetypes that were established by Berkeley Softworks when GEOS 2.0 was created varied between 0 and 15. Higher numbers were unused at the time. It was possible for software designers to introduce new filetypes and assign new filetype numbers to them. As an example, geoFAX uses special printer drivers that are totally different from the normal GEOS printer drivers. They operate differently, so they should not use the same filetype, which is 9. So, they have been assigned an unused filetype number, 22. geoSHELL commands were given a filetype of 21.
  26. When you click on a drive icon in gateWay, the disk will be opened and the directory is read. gateWay will proceed to display the directory on the screen and list the filenames along with the filetypes. It has a table of filetype names that it indexes into and then calls a GEOS kernal routine called PutString to display the text on the screen. Unfortunately, GEOS programs have to be careful when calling PutString. PutString will crash the computer or lock it up if it encounters certain unprintable characters. This table of filetype names that gateWay points to for PutString to print contains a total of 22 entries. They include the normal filetypes from 0 through 15. Then for filetype 16, gateWay calls this a folder. Filetype 17 is used for gateWay documents.
  27. Then gateWay uses this same table of names to display
  28. certain disk dr
  29. Then gateWay uses this same table of names to display
  30. certain disk drive types. These are located within entries 18 through 21. Entry number 21 says "Hard Disk". This explains why gateWay identifies a geoSHELL command as a Hard Disk.
  31. Then the table of names ends. Program code follows this table and so when gateWay encounters a geoFAX printer driver, it is pointing at program code, which is unprintable. This is when gateWay locks up trying to display a directory containing a geoFAX printer driver. gateWay should have been written to handle unrecognized filetypes a little differently. It should have pointed PutString at something that says "Unknown Filetype". Any future version of gateWay, I'm sure will be written to work this way.
  32. G@PATCHING GATEWAY
  33. This is where this patch comes in. This patch modifies a portion of gateWay so that it will no longer crash if an unrecognized filetype is encountered. Any filetypes of 22 or higher will be listed as being a SYSTEM file. This doesn't help you to identify the filetype, but in most cases, you will likely know what the file is for by it's filename. At least, you will be able to use gateWay and not crash the computer anymore, at least not for this reason.
  34. Using this patch is quite easy. I recommend that you take a freshly formatted disk and copy gateWayPatch to it. Then copy one more file to the disk. This file would either be GATEWAY or GATEWAY_128. Then open the disk and double click on gateWayPatch to run it.
  35. The only disk that will be accessed is this disk that you are running gateWayPatch from. gateWayPatch will search the disk for either GATEWAY or GATEWAY_128 and proceed to modify it as needed.
  36. The screen will remain blank while the work is going on. When it is finished, a dialogue box will pop up informing you that the patch was successful. The message in the dialogue box will say "Patch Completed...". Just click on "OK" and you will exit out of the program and return to the Desktop, gateWay, geoSHELL, or wherever you loaded gateWayPatch from.
  37. If gateWayPatch failed, an error message will be displayed in the dialogue box instead. One of the following 3 messages will be displayed and will give you a clue as to why the patch failed:
  38. "Disk Error"
  39. This error is obvious. Check your disk or the drive. Perhaps your disk is corrupted, or maybe you left the write protect on.
  40. "gateWay Not Found"
  41. If GATEWAY or GATEWAY_128 is not on the disk, this message will be displayed.
  42. "Unknown Version"
  43. This patch should work with all versions of gateWay, but you never know. If gateWayPatch doesn't recognize your version for some reason, this message will be displayed. This message will also appear if this particular copy of gateWay has already been patched.
  44. G@AFTER PATCHING
  45. Once you have patched a copy of GATEWAY or GATEWAY_128, simply copy the file to your boot disk in place of the copy that is already there. If you have GATEWAY or GATEWAY_128 on any other disks, you will want to replace those copied also. The next time gateWay is loaded into memory from disk, the patch will be in effect.
  46. Do not copy it to your original gateWay disk! Always leave your original unmodified so that you can start over fresh if needed.
  47. You will want to keep track of this patched version. On the outside, there will be no indication that it has been changed. You might want to change the text in the info box to reflect the fact that you have patched it. If you try to patch gateWay a second time, you will get the error message, "Unknown Version". This might be one way to tell if it has already been patched.
  48. G@IF PROBLEMS OCCUR
  49. Keep in mind that I did not write gateWay. I don't use it myself and so I can't help you with it's use. However, if you have any problems with gateWayPatch, you can contact me through The Speed Zone BBS at (517) 322-2386. The BBS runs 24 hours a day. All Commodore users are welcome. Just leave a message in one of the message bases to Maurice Randall.
  50. gateWayPatch Documentation     Page PAGE
  51. including the filename, the location of the starting block, the location for the header block, the creation date and time, the files
  52. gateWayPatch Documentation     Page PAGE
  53. including the filename, the location of the starting block, the location for the header block, the creation date and time, the filesize, and t
  54. gateWayPatch Documentation     Page PAGE
  55.