home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / utility / solapak / solapak.doc < prev    next >
Text File  |  1988-05-18  |  11KB  |  258 lines
  1. ==========================
  2. === SOLAPAK v3.03 DEMO ===
  3. ==========================
  4.  
  5.   This SOLAPAK demo set consists of the following files:
  6.  
  7.     SOLAPAK.DOC    - this file
  8.     SOLAPAK.PRG    - installation program to place in AUTO folder
  9.     SOLAPAK.ACC    - desk accessory to place on boot disk
  10.     DESKTOP.INF    - saved desktop file with disk "M" pre-installed
  11.  
  12. - SolaPak is a multifunction utility program that loads on boot up when placed
  13.   in your AUTO folder.  It has a companion desk accessory for control of some
  14.   of its features.  The use of the desk accessory is optional in most cases.
  15.  
  16.   SolaPak provides the following functions:
  17.     Screen Clock
  18.     Screen Saver
  19.     Reset tolerant ramdisk with file autoloading
  20.     True Print Spooler
  21.     Print Buffer
  22.     Sets time & date
  23.     Sets printer width
  24.     
  25. - Unlike some multipurpose desk accessories which take up RAM for
  26.   functions you're not interested in using, SOLAPAK v3.0 is different.
  27.   A new dynamic loading method has been introduced.  Upon boot up, the
  28.   functions of the program which are not desired are removed from the
  29.   program image resulting in less memory used.  So if you've already
  30.   got your favorite screen clock, for example, just disable SOLAPAK's
  31.   and there will be no penalty in RAM wasted.
  32.  
  33. === PRINT SPOOLER ===
  34.   Up to 8 files queued for printing, each can have different print
  35.   attributes.  32 user defined print option buttons lets SolaPak support
  36.   nearly every parallel printer.  Setups for dozens of printers are
  37.   provided along with a utility for making your own custom printer control
  38.   buttons.  Built-in features exist for producing top, bottom, and left
  39.   margins as well as printing double or triple spaced text.  Queue controls
  40.   let you pause and continue printing or delete individual files from the
  41.   queue.
  42.  
  43.   New PRINTERCEPTOR feature intercepts printer output from programs using
  44.   standard TOS calls and redirects it thru the spooler.  Unlike most spoolers
  45.   or print buffers, SolaPak does not require a separate spooler buffer.  It
  46.   "borrows" space from the integrated ramdisk.
  47.  
  48. === RAMDISK ===
  49.   Low overhead, ultra fast, reset tolerant, autoloads user specified files on
  50.   boot up.  User selected ramdisk size, drive ID, number of files.  Hard
  51.   disk compatible.
  52.  
  53. === SCREEN SAVER ===
  54.   Turns your monitor off during periods of keyboard and mouse inactivity.
  55.   Restores screen instantly at the touch of a key or mouse movement.  New
  56.   modem activity sensor makes it great for BBS's.
  57.  
  58. === and MORE... ===
  59.   SolaPak is not copy protected; will automatically install at boot; works
  60.   in all screen resolutions; sets time and date; disables disk write verify;
  61.   sets printer width; includes new screen clock;  30 page manual on disk;
  62.   An installation utility makes nearly every feature OPTIONAL!  SolaPak is
  63.   written entirely in assembly language for the fastest speed and smallest
  64.   code.
  65.  
  66.  
  67. ===========================
  68. === Ramdisk Autoloading ===  excerpt from the SolaPak manual
  69. ===========================
  70.  
  71.    Built into SOLAPAK.PRG is the ability to load a user specified list of
  72.    files into the ramdisk.  With this option enabled SolaPak looks for a
  73.    file called COPY2RAM.DEF in the AUTO folder of the boot disk.  If this
  74.    file is found it is opened and used as the list of files to be loaded.
  75.    If this file can't be found then the line specified in SPMOD by
  76.    'RAM LOAD =xxxxx' is used.  This line is treated as the equivalent of
  77.    COPY2RAM.DEF with a single line in it.
  78.  
  79.    The ramdisk loading algorithm supports wildcards of '*' and '?'.  It
  80.    will copy folder structures and files under those folder structures down
  81.    to a level of approximately 4 folders deep.  It supports a "from,to"
  82.    syntax that lets you rename files, move files out of folders, or move
  83.    files into folders as you load them into the ramdisk.
  84.  
  85.      Syntax:    <source file>  [,  <dest file>]  [; comments ]
  86.  
  87.      Examples:    file1.prg , \tools\file1.prg    ; move down 1 level
  88.         file2.prg , \tools\editor.ttp   ; move and rename
  89.         \auto\file3.doc, file3.doc    ; move up 1 level
  90.                 B:\include\*.h                  ; wildcard usage
  91.                 \source\*.* , \source\*.*    ; replicate a folder
  92.         \source\*.*            ; copy folder into ramdisk
  93.                 *.doc , \fold1\fold2\*.*        ; move down 2 levels
  94.         A:\fold1\fold2\*.* , \fold2\*.*    ; copy and move up 1 level  
  95.                 *.asm , *.s                     ; wildcard renames too!
  96.  
  97.  
  98. ====================
  99. === Memory Usage ===
  100. ====================
  101.  
  102.   The following table identifies valid combinations of the five major
  103.   functions of SolaPak and the corresponding RAM usage resulting from
  104.   the installation of that particular combination.  (numbers may vary
  105.   slightly for the DEMO version).
  106.  
  107.               R   S   I
  108.               A   P   N
  109.       C   S   M   O   T
  110.       L   A   D   O   C
  111.       O   V   I   L   E
  112.       C   E   S   E   P         RAM
  113.       K   R   K   R   R         usage
  114.     =====================       =====
  115.       *   -   -   -   -        1536 bytes
  116.       -   *   -   -   -         512
  117.       -   -   *   -   -         512 +
  118.       -   -   *   *   -        1536 +
  119.       -   -   *   *   *        3072 +
  120.       *   *   -   -   -        1536
  121.       *   -   *   -   -        1536 +
  122.       *   -   *   *   -        2560 +
  123.       *   -   *   *   *        3584 +
  124.       -   *   *   -   -        1024 +
  125.       -   *   *   *   -        2048 +
  126.       -   *   *   *   *        3072 +
  127.       *   *   *   *   *        4096 +
  128.     =====================
  129.    "+" denotes additional ramdisk overhead.
  130.  
  131.   The ramdisk overhead is determined by the size of the ramdisk plus the
  132.   number of files to be supported.  We have tested many other ramdisks
  133.   (YARD, ETERNAL v2.0, SI_RAM, MEGAMATIC v1.18, INTERSECT v4, L-RAM v1.0)
  134.   and believe that SolaPak has the lowest overhead of them all when
  135.   configured only as a ramdisk.
  136.  
  137.   The desk accessory memory usage is ~8,500 bytes.  The use of the desk
  138.   accessory is optional, except when the use of the SPOOLER is desired.
  139.  
  140.   The ramdisk speed has been benchmarked with the following results:
  141.     transfers of   1K files @ 1,241,200 bytes/second.
  142.     transfers of 100K files @ 1,500,350 bytes/second.
  143.  
  144.  
  145. =======================================
  146. === limitations of the SOLAPAK demo ===
  147. =======================================
  148.  
  149. - The demo will only print the first 8000 bytes of a file using the spooler.
  150.   However, files printed using the PRINTERCEPTOR are not limited.
  151.  
  152. - The demo does not come with SPMOD, a utility for changing the options and
  153.   configuration of SolaPak.
  154.  
  155. - The demo does not come with the full instructions.  The commercial version
  156.   includes a 30 page instruction file on disk.
  157.  
  158. - The demo is set up with printer codes and printer buttons for an EPSON
  159.   FX-85 printer.  The commercial version (real thing) lets you redefine
  160.   all buttons.  The real thing comes with some example button definitions
  161.   for over 17 common printers.  Printers not supported can be easily set up
  162.   by the user.
  163.  
  164. - You are prompted as to whether to install the SCREEN CLOCK.  This can be
  165.   set as enabled, disabled, or prompt on boot-up in the real thing.
  166.  
  167. - The screen clock digits use the "digital" font in monochrome mode. é⇧ם]⇧Y∙±üij⑨±æ    ±Çqij①⇧⇧9≡0    ±ח≡æ⇧1ijÖ±⓪⇧τ\⇧Õ>✓ו① real thing.
  168.  
  169. - You are prompted as to whether to i~staqÄ⑦§∮Ñ≡Ç4IÇ*q⇩Ü
  170. Øij&8™@âh⇩⇦@1ãÃ⓪12åà⓪⓪9Ø´⓪0¨É2Ã0õ62Ø⑥⓪24¨ãõ8גY♪✓ץê¢ף\✓ףê⑧¢ף§♪]\✓ə[êə⑨HÖX[✓əə[ÖיâBâBïH⑤ə⑨HןץÖY[êן]Ö\êə\זך]✓זך[£ךHך⑨[H⑧X§ə]Ü]H⑧\זך[✓⑧\ז§\ךH⑧[Ö⇨Bê✓əך^X¢ן\Ö✓⑧X§ə]Ü]Kê✓③[ך⑨[Hך[£ם[Öז⑧ן[ê⑧ÖH⑨ə\ןX¢⑨Y✓ףêə⑨HÖX[✓əə[ÖיâBâBïH⑥[§H⑧\ÖH¢ף\⑨Y✓⑧\זזם⑨]ə⑨\êזə[£ler install.
  171.   You can fix the size of the ramdisk, or have it ask on boot.  You can
  172.   also adjust the number of files supported in the root directory up to a
  173.   value of 256 or have it prompt you on boot.  And the drive ID used is
  174.   adjustable between "C" thru "P" in the real thing.
  175.  
  176. - The time and date are set on boot up.  This can be disabled on the real
  177.   thing.
  178.  
  179. - Disk write verifies are disabled on boot up.  This can be disabled on
  180.   the real thing.
  181.  
  182. - Printer width is set to 8 inches.  This can be set for 15 inches or disabled
  183.   on the real thing.
  184.  
  185. - Ramdisk autoloading is enabled and in the absence of a COPY2RAM.DEF
  186.   file in the AUTO folder SolaPak will load all *.DOC files into the
  187.   ramdisk on boot up.  The autoloading can be disabled in the real thing.  
  188.  
  189.  
  190. ===============================
  191. === HOW TO INSTALL THE DEMO ===
  192. ===============================
  193.  
  194.   *  format a fresh disk
  195.  
  196.   *  Create an AUTO folder on the new disk
  197.  
  198.   *  If you have an add on clock, place the time setting utility provided
  199.      by the manufacturer into the AUTO folder.
  200.  
  201.   *  Copy SOLAPAK.PRG into the AUTO folder.
  202.  
  203.   *  Copy SOLAPAK.ACC, SOLAPAK.DOC, and DESKTOP.INF into the new disk.
  204.  
  205.   *  Reboot your computer using a complete power off.
  206.  
  207.  
  208. ===========================
  209. === HOW TO USE THE DEMO ===
  210. ===========================
  211.  
  212.   The Printerceptor should work transparently.  Use the normal print 
  213.   method of the utility you are working with.  If it uses the standard TOS
  214.   and GEM printer calls it will be captured by the printerceptor and
  215.   queued thru the spooler/ramdisk.
  216.  
  217.   In the desk accessory "SOLAPAK..."
  218.  
  219.   *  click on the watch icon to toggle the screen clock on/off.
  220.  
  221.   *  click on the monitor icon to toggle the screen saver on/off.
  222.  
  223.   *  click on the printer icon to halt output from the spooler and
  224.      printerceptor to the printer.
  225.  
  226.   *  click on the funnel icon to disable the printerceptor and allow
  227.      printer output to go straight to the printer rather than thru
  228.      the spooler's intercept scheme.
  229.  
  230.   *  click on buffer flush to send about 1000 null bytes to the printer
  231.      to flush the queue or unstick jammed graphics dumps.
  232.  
  233.   *  click on the hard reset button to simulate a power-off reset of
  234.      your computer (ramdisk contents will be lost).
  235.  
  236.   *  click on "PRINT FILE" to select a file to print, then select print
  237.      buttons and finish with PRINT/CANCEL.
  238.  
  239.   *  click on "SOLAPAK v3.0" and then select a filename to perform a
  240.      quick print using the last button settings.
  241.  
  242. ====================
  243. === HOW TO ORDER ===
  244. ====================
  245.  
  246.   Send cash, check, or money order for $30 to:
  247.  
  248.     Tim Hunkler
  249.     Solar Powered Software
  250.     1807 N. Evergreen
  251.     Chandler, AZ  85224
  252.  
  253.   Arizona residents add appropriate sales tax.
  254. ------------------
  255.   For questions leave mail on GENIE for T.HUNKLER
  256.       or
  257.   Join in the discussions on GENIE under the ATARI round table.
  258.