home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 074.lha / SpTil.Doc < prev    next >
Text File  |  1986-11-20  |  13KB  |  249 lines
  1.  
  2.                                 SpTil
  3.                         A MutantWare Production
  4.  
  5. Sptil is a multi-process file select print utility, and consists of two
  6. separate files; Sptil - the editor and Spl - the writer. The object of
  7. the game is to select files to print, assign the various attributes for
  8. printing, and then copy them to a queue for the writer to output to
  9. the printer.  After the files have been placed in the queue the editor may
  10. be opened and closed as required to perform any necessary maintainance.
  11.  
  12. And it goes like this...
  13.  
  14.    (1) Start Spitil, either from CLI or Workbench its your choice as usual.
  15.        After the windows open the first time, you will experience a delay as
  16.        AmigaDOS loads the necessary printer stuff.  This only happens once per
  17.        session, the really bad part is there is no easy way to get rid of it 
  18.        so it eats appx 35k of memory by leaving the "printer.device" task
  19.        running.  But then again its no different than copying something to PRT:.
  20.  
  21.    (2) Assign Spool-Que residency.  Using the drive gadgets in the right
  22.        window locate the appropriate drive and path for the Que to reside.
  23.        Use the Control Spool-Que menu item to assign the Que residence.  The
  24.        obvious choice for this is RAM: however any drive will do.
  25.        Assigning the Que creates a directory named Spool-Que which
  26.        will contain the spool files.
  27.  
  28.    (3) Assign the various printing attributes by using the PRINT menu item.
  29.        These attributes include Quality or Draft mode, characters per inch,
  30.        and how the file is to be formatted.  Select Format off if your file(s)
  31.        are already paginated, or you don't want to skip page breaks.  If Format
  32.        is left on, you may select a Form using the Form menu subitem.  See
  33.        the description below for detail.
  34.  
  35.        Once your selections are complete, you may copy files to the queue.
  36.        All files copied will be printed with the selected attributes.  If you
  37.        like, you may change attributes for each file copied.
  38.        
  39.    (4) Select the files to print in the left window then hit the copy gadcget
  40.        at the top.  The program currently does not support priorities so if
  41.        you are concerned about the order they print in, I suggest you copy one
  42.        at a time.  Once in the Que they will print in first in, first out order.
  43.        If the Spool-Writer is ON the first file will start printing as soon
  44.        as it hits the queue.  
  45.        
  46.    (5) Print attributes may be changed at any time.  Use the Control menu
  47.        item to Edit Spool Files.  Place the file on Hold using the same menu,
  48.        to prevent it from printing while you edit.  An edit window will open
  49.        allowing the print attributes to be changed.  The number of copies can
  50.        be changed as well.  The print attributes (including Hold status) are
  51.        not actually changed until the Edit Next or the close window gadget
  52.        is selected.  If the file you are editing is printing, it should be
  53.        placed on Hold first, then reselected before you begin editing.
  54.  
  55.    (6) Forms allow you to specify how the file should be output to the printer.
  56.        The spool writer will skip page breaks, print headings and footings,
  57.        and supports margins and variable tab stops.  A variety of paper sizes,
  58.        including pre-printed forms can be accomodated by setting lines per inch
  59.        and page length.  Forms are stored on disk and may be individually
  60.        selected for each file to be printed.  Keep this in mind if you are
  61.        tempted to remove your SpTil disk.
  62.        
  63.        Forms are selected in the same manner as the other print attributes.
  64.        If you use the Form Select subitem in the Print menu, the avaiable
  65.        Forms will be displayed for selection.  The Form may also be set
  66.        by using the Edit Spool Files subitem in the Control menu.  You must
  67.        manually (ugh!) type in the file name to select the form file.  Your
  68.        success will depend on your memory and typing skills, but this is a
  69.        handy short-cut if you want a special Form for one file out of a group.
  70.        If the named Form file cannot be found, the default Form will be used,
  71.        without notification.  Don't worry, it really is a nice Form.
  72.  
  73.        SpTil will create a subdirectory called Forms.  This directory will
  74.        be located in the same directory where SpTil resides, and should not
  75.        be moved, altered, spindled, folded or mutilated.  A default Form
  76.        will be created and placed in (of all places) the Forms directory.
  77.        
  78.        The Forms Editor is used to modify or create new Forms.  Use the
  79.        Edit Forms subitem in the Print menu.  The Forms Editor has it's
  80.        own menus, and no small number of gadgets.  These are used to specify
  81.        your form.  A new Form may be created by simply changing the Form File
  82.        Name.  Change any values you wish and then select Edit Next or the 
  83.        close window gadget to save your Form.  You may cancel your edits
  84.        by clearing the Form File Name before you exit.
  85.  
  86.        The Delete item in the Forms menu will delete the Form file named
  87.        above the edit window.  This will be the last file you selected to
  88.        edit and not necessarily the name in the Form File gadget, if you
  89.        changed it.  Got that?
  90.        
  91.        The Spool Writer supports special characters in the headings and
  92.        footings.  The sequence .f will be replaced by the file name. A .d
  93.        will be replaced by the date and .p will produce the current page
  94.        number.  Refer to the values shown in the default Form file.  Note
  95.        that headings and footings do not obey the normal laws governing
  96.        left and right margins.  If you want your headings to line up with
  97.        the margin, you must insert an appropriate number of spaces in the
  98.        heading itself.       
  99.        
  100.                              Form Gadgets
  101.              1) Name   - Form file name = any legal name
  102.              2) Lines  - Maximum physical lines per page
  103.              3) Chars  - Maximun physical characters per line
  104.              4) LMarg  - Left margin
  105.              5) RMarg  - Right margin
  106.              6) Tab    - Number of spaces to expand tab to
  107.              7) First  - Location of first line to print excluding heading
  108.              8) Last   - Location of last line to print excluding footing 
  109.              9) Head   - Location of Heading line
  110.             10) Foot   - Location of Footing Line
  111.             11) Head   - Heading string
  112.             12) Foot   - Footing string
  113.  
  114.  
  115.    (6) Remove Spool-Writer process with Control Spool Writer menu subitem
  116.        when finished.  Close editor via either menu item or close gadget.
  117.  
  118.    
  119.    (7) Send cash, check or money order to authors.
  120.  
  121.  
  122.      
  123.            The Menus
  124.  
  125.    (1) Control  (a) Spool Writer  Stop   - Can stop while printing.  Will not
  126.                                            send form feed so you can restart
  127.                                            at same location.  
  128.                                   Start  - What it is...
  129.                                   Remove - Cannot remove while spool files exist.
  130.                                            Either print or delete them.
  131.  
  132.                 (b) Spool Files   Hold   - Select for files to be placed in queue
  133.                                            with HOLD status ON.  Files on HOLD
  134.                                            will reside in queue but will not print.
  135.                                   Release- Opposite of above.
  136.                                   Edit   - Opens EDIT window to verify and change
  137.                                            print attributes.
  138.                  
  139.                 (c) Spool-Que     Assign - Assigns Que residency after location
  140.                                            with drive gadgets if necessary.
  141.                                   Select - Removes existing Que and allows
  142.                                            subsequent relocation and assignment.
  143.                                            Cannot be done if files exist in queue.  
  144.  
  145.                 (d) ...About      Aint to proud to beg.
  146.  
  147.                 (e) Quit          Remove editor only.
  148.  
  149.    (2) Print    (a) Format        ON     - Paginate with headings and footings.
  150.                                   OFF    - Print as is without page breaks.
  151.  
  152.                 (b) Quality       ON     - Near letter quality if you got it.
  153.                                   OFF    - For the normal people.
  154.            
  155.                 (c) C.P.I.         Pica  - 10 characters per inch.
  156.                                   Elite  - 12 characters per inch.
  157.                                Condensed - Condensed mode ( 15-17 cpi ).
  158.  
  159.                 (d) Forms         Select - Select a Form from the Que window.
  160.                           Edit   - Modify or Create Forms.
  161.  
  162.                 (e) Delete        Use to remove files in Spool-Que.  Cannot delete
  163.                                   a file while it is printing.  If this is required
  164.                                   STOP writer first then EDIT the file and place
  165.                                   on HOLD.  After closing the edit window you 
  166.                                   may then DELETE the file.
  167.  
  168.    (3) Source   (a) Select All    Selects all files in source window.
  169.                 
  170.                 (b) Clear All     Undoes the above in case you screwed-up.
  171.       
  172.                 (c) File Info     Size      -  Displays file size.
  173.                                   Date      -  Displays file dates.
  174.                                   Time      -  Displays file times.
  175.  
  176.                 (d) View          Source    -  View the source before you spool it.
  177.                                   Spool-Que -  View the Spool Files.
  178.              
  179.  
  180.   Misc info   Clicking on the Spool-Que window without selecting a file will
  181.               update the Que window display with what is really there.
  182.      
  183.  
  184.        Upcomming Attractions
  185.  
  186.    (1) Priorities - Print in prioritized order.
  187.    (2) Que All    - Interception and queueing of ALL output to printer.
  188.    (3) Restart    - Restart printing of file on any page.
  189.  
  190.  
  191.  
  192.                                How It Works
  193.                        For Those That Really Give A !$@#
  194.  
  195. Using the AmigaDos calls CreateProcess and LoadSeg, Sptil creates a child
  196. process the Spool Writer.  It then sets up a system of messages and ports
  197. to keep each other abreast of the current state of affairs.  While alive
  198. the Writer mindlessly searches for the next available file to print, and like
  199. a good child does what its parent ( the Editor ) tells it to do.  After months
  200. of fighting with the printer.device; this release works via PRT: the printer 
  201. handler.  The problem with the printer.device is that it seems to have a mind 
  202. of its own and will not consistantly control the printer.  PRT: and its associated 
  203. escape sequences seem to never fail.  Unfortunatly IO is handled via Lattice 
  204. fcalls and does not task very well thereby causing some response delays at times.
  205. Exec IO requests handles this more effeciently however sometimes they just dont
  206. work in the same place where they just did work.  I may be ignorant but not 
  207. stupid.  Anyway I am still working on an acceptable solution and hope this works 
  208. in the interim.
  209.  
  210.                              Best wishes and happy Sptiling,
  211.                                        
  212.                                        Mark Gault
  213.  
  214.  
  215.           REVISIONS:
  216.  
  217. 1.0 - 6/87  Beta test version
  218.  
  219. 1.2 - 8/27   No comments from world on v-1.0 so I assume it works.
  220.           1) Limited number of files in queue to 50 in order to save memory.
  221.           2) Spl closes parasitic window so graciously provided by _main()
  222.              and opens its own for a snazzier display.
  223.           3) Now counts down pages left to print is Spool Writer window.
  224.           4) Has a real On/Off indicator for the Spool Writer.
  225.           5) Forms - Just a tease, creates & edits form definitions but alas
  226.              Spool Writer does not utilize them yet.  Forms directory is
  227.              created as a sub-directory of wherever Sptil resides.
  228.  
  229. 2.0 - 9/87  /* Beta test version  - keep water bucket handy */
  230.  
  231.           1) Forms for your every need.
  232.  
  233.             Because of the numerous combinations of printing available through
  234.             the Forms Editor not all has been tested as of this date but all
  235.             that has works.  Its big but its FUN.  Send feedback to addresses
  236.             listed.  Remember If you don't bitch it won't get fixed, 'cause
  237.             it works on my printer and I can't see yours from here.
  238.                                        
  239.                                        meg
  240.  
  241. 2.1 - 9/27  1) Various buglets squashed.
  242.             2) View now supports horizontal scrolling for line over runs.   
  243.             3) A new executable support file has been added courtesy of
  244.                Dan Franki.  Named KillSpl, its purpose in life is to unmercifully
  245.                terminate the Spl process and make life easier by allowing the
  246.                operator to remove the Spool Writer after printing without 
  247.                having to open SpTil.  Made for the lazy at heart this program
  248.                is not required, only extremely convenient.
  249.