home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d568 / schoonschip.lha / Schoonschip / SchipAMI.LZH / SchipAmi / Install.txt < prev    next >
Text File  |  1991-11-12  |  5KB  |  100 lines
  1. AMIGA SCHOONSCHIP INSTALLATION
  2.  
  3. 1.  Machine Requirements
  4.  
  5. This version of Schoonschip has been tested on an Amiga 2000 with AmigaDOS
  6. 1.3, and on an Amiga 3000 with AmigaDOS 1.3 and 2.x, and requires a little
  7. less than 120,000 bytes of contiguous memory for the program.  There are
  8. currently two executable versions, a "small" workspace version designed for
  9. machines with 512 Kbytes of memory, in the file SchipAMI_S.LZH, and a
  10. "standard" workspace version designed for machines with an extra 1,000,000
  11. bytes of contiguous memory for workspace aside from the program itself, in
  12. the file SchipAMI.LZH.  The small version needs 335,000 contiguous bytes of
  13. workspace.
  14.  
  15. 2.  Command Line Mode
  16.  
  17. To run Schoonschip from the command line only, without icons, simply copy
  18. the executable file Schip into some directory in your execution path, for
  19. example, the C: directory.
  20.  
  21. 3.  Icon Mode
  22.  
  23. Schoonschip is intended to be command line driven, but icons are included
  24. with the Amiga version for those who want to try them.  We think the icons
  25. look best in 640x200 resolution mode.  If you are not running AmigaDOS 2.x,
  26. in its default 4-color mode, you might want to use IconEd to modify the
  27. colors.
  28.  
  29. First copy the Schip.info icon into the same directory as the Schip
  30. program.  It should behave like a normal Amiga icon; and although it seems
  31. to us an awkward mode of operation, we have implemented the method of
  32. holding down the shift key while clicking on document icons, to represent
  33. file name arguments normally given on the command line, then clicking on
  34. the Schip icon (shift key still held down) to run the program.
  35.  
  36. The program can be run from a document icon with the help of two freely
  37. distributable utilities provided by Rich Franzen, AtatJ and IconJ, included
  38. here, plus a script, an example of which is also included, called DoIcon. 
  39. The AtatJ and IconJ programs need to be put into the C: directory.  The
  40. script uses AtatJ to attach an icon to a program text file, which calls
  41. Schoonschip when clicked.  It could be part of a larger script that calls
  42. your favorite editor for writing Schoonschip programs, then attaches an
  43. icon when your editor is finished.
  44.  
  45. As it stands, the script is invoked like this:
  46.  
  47.     DoIcon filename
  48.  
  49. where "filename" is the name of a Schoonschip program text file.  This will
  50. produce an icon file called filename.info, which causes Schoonschip to run
  51. the program filename when the icon is clicked, writes the output to
  52. filename.out, and displays it with the More progream.
  53.  
  54. It is important that this script be able to find the icon template file
  55. SchipDoc.icon, so you need to edit the script to make its path explicit;
  56. and the paths for the Schip and More executables have to be explicit in the
  57. script as well, otherwise the IconJ tool will not do its job properly. 
  58. IconJ is the actual tool associated with the document icon, and it runs a
  59. script embedded in the icon to call Schoonschip.  For more information on
  60. how IconJ and AtatJ work, consult Fred Fish volume number 321.
  61.  
  62. 4.  Workspace Size Patch
  63.  
  64. The small and standard workspace versions in this distribution need a
  65. contiguous workspace of 335,000 and 1,0000,000 bytes, respectively.
  66. Although it allocates that much memory and won't run without it, the
  67. program actually sets its internal workspace smaller (313,272,
  68. respectively, 476,348 bytes).  There is startup code in front of the
  69. Schoonschip code which uses a little of the extra space.
  70.  
  71. The built-in sizes work well for problems that don't take really large
  72. amounts of time (Schoonschip will go to the disk if it needs more
  73. workspace), even for the smaller workspace, and on the other hand seem not
  74. too large for most systems to handle.
  75.  
  76. The size of the internal workspace (the 313,272 or 476,348 bytes), and how
  77. it is divided between input and output spaces, can be changed from the
  78. command line.  See Appendix A of the manual, or execute
  79.  
  80.    Schip is=0
  81.  
  82. It is possible to patch the executable file to increase the maximum work
  83. space size (the 335,000 or 1,000,000 bytes).  Simply use a utility like
  84. NewZap to change the long word (4 bytes) at offset 114 hex in (a copy of)
  85. the file Schip from its current value of 0005 1C98 hex (335,000) or 000F
  86. 4240 hex (1,000,000) to something larger, in accord with your available
  87. contiguous memory.  This does not change the default internal workspace
  88. size, but the internal work space can now be increased from the command
  89. line as indicated above, to something somewhat below the new maximum.  How
  90. much below is undocumented.  The program will let you know if it doesn't
  91. have enough space.
  92.  
  93. David N. Williams
  94. Ann Arbor, Michigan
  95. October 10, 1991
  96.  
  97. David_N._Williams@um.cc.umich.edu
  98.  
  99. DWILLIAMS@UmiPhys.bitnet
  100.