home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / system / printfiles / english / printfiles.doc.english < prev    next >
Encoding:
Text File  |  1995-02-27  |  37.7 KB  |  983 lines
  1. *********************************************************************
  2. *                         PrintFiles                                *
  3. *                        Version 1.4e                               *
  4. *                                                                   *
  5. *               Copyright © 1992 by K.Klingbeil                     *
  6. *                     All rights reserved                           *
  7. *********************************************************************
  8.  
  9. *********************************************************************
  10. DISCLAIMER
  11. The author cannot be held liable for the  suitability or  accuracy
  12. of this manual  and/or  the  program(s)  it  describes.   Any  damage
  13. directly  or indirectly caused by the use or misuse of  this manual
  14. and/or the  program it describes is the sole responsibility of the
  15. user her/him self.
  16. *********************************************************************
  17.  
  18. ***********************************************************************
  19. WARNING-WARNING-WARNING-WARNING-WARNING-WARNING-WARNING-WARNING-WARNING
  20.  
  21. If you carelessly change the default settings of the printer spooler
  22. directory, programs and data may be deleted !!!
  23. Read chapter 6 before using the printer spooler directory !!!
  24.  
  25. WARNING-WARNING-WARNING-WARNING-WARNING-WARNING-WARNING-WARNING-WARNING
  26. ***********************************************************************
  27.  
  28.  
  29. *********************************************************************
  30. DISTRIBUTION:
  31. PrintFiles, © Copyright 1992,1993 K.Klingbeil. All rights reserved. This
  32. Program is FREEWARE so no financial donations are required ( but welcome ).
  33. This   program  may  be  freely  distributed  as  long  as all source code,
  34. documentation and executable remain unchanged and are included  with the
  35. distribution.
  36.  
  37.  
  38. *********************************************************************
  39. *               Contents of this manual                             *
  40. *********************************************************************
  41.  
  42. 1. Introduction
  43. 2. Installation
  44.    2.1 Requirements
  45.    2.2 Installation
  46. 3. Quickstart
  47. 4. How to use PrintFiles
  48.    4.1. The printer icon
  49.    4.2. The control window
  50.         4.2.1 open the control window
  51.         4.2.2 close the control window
  52.         4.2.3 the settings of the control window
  53.    4.3. The prefs window
  54.         4.3.1 open the prefs window
  55.         4.3.2 close the prefs window
  56.         4.3.3 the settings of the prefs window
  57.    4.4. The filehandler window
  58.         4.4.1 open the filehandler window
  59.         4.4.2 close the filehandler window
  60.         4.4.3 the settings of the filehandler window
  61.    4.5. the replace window 
  62.         4.5.1 open the replace window
  63.         4.5.2 close the replace window
  64.         4.5.3 the settings of the replace window
  65. 5. The Arexx-Port
  66.    5.1. Command summary of the Arexx-Port
  67. 6. The Spooler directory
  68.    6.1 Usage
  69. 7. Starting Printfiles
  70.    7.1. Usage from CLI/Shell
  71.    7.2. Usage from Workbench
  72. 8. Notes
  73.  
  74. *********************************************************************
  75. *                      1. Introduction                              *
  76. *********************************************************************
  77.  
  78. PrintFiles is designed to replace the Printfiles-command distributed
  79. with your Workbench disk. Unlike the original printfiles it is more
  80. user-friendly and offers you much more possibilities , e.g. Headlines,
  81. date,time...
  82.  
  83. The features are:
  84.  
  85.     - Printer Icon on the Workbench.
  86.       To print a File simply drag its icon onto the printer icon.
  87.     - A print list of unlimited size.
  88.     - Files are also inserted into the print list by dragging their
  89.       icons into the control window.
  90.     - every file in the list may have its own printer settings
  91.     - You can print headlines, baselines, date, time, filename,
  92.       page numbers and line numbers.
  93.     - You can set your printer to draft/lq quality.
  94.     - Arexx-Port gives you full control over Printfiles.
  95.     - Saves its preferences as Arexx-Scripts  #
  96.     - Saves Icons for Arexx-Scripts which are prepared to be
  97.       executed by double-clickicng them.
  98.     - Prints Icon Images
  99.     - Passes filenames to external programs for other purposes than
  100.       printing
  101.     - Output can be directed to the printer or into a file
  102. Try it !
  103.  
  104. *********************************************************************
  105. *                    2. Installation                                *
  106. *********************************************************************
  107.  
  108. 2.1 Requirements
  109.     Printfiles runs only under OS 2.04 with system libraries V37+.
  110.     Printfiles uses only about 70K memory so that it will run even on
  111.     512K Amigas. Harddisk and/or additional memory are not required, but
  112.     (always) useful.
  113.  
  114. 2.2 Installation
  115.     Printfiles needs no complex installation procedures. Just copy the
  116.     program into your c: or WBStartup directory.
  117.     If you want to use the Arexx-Port of Printfiles, be sure that the
  118.     RexxMaster Process is running before you attempt to run Printfiles.
  119.     Printfiles will not work if the Workbench is closed, so be sure that
  120.     you start PrintFiles after the LoadWB command.
  121.  
  122.     NOTE: PrintFiles cannot be started twice !
  123.  
  124.     To start Printfiles automatically at Startup you can:
  125.        a. add the line 'PrintFiles' to the File s:user-startup
  126.        b. copy Printfiles into the WBStartup Drawer.
  127.           In this case you may add the ToolType DONOTWAIT to the
  128.           PrintFiles icon.
  129.        c. copy a Printfiles-generated Arexx-Script (with Icon !) into
  130.           the WBStartup drawer. This is the easiest way to bring up
  131.           the program with your desired settings.
  132.  
  133. *********************************************************************
  134. *                     3. Quickstart                                 *
  135. *********************************************************************
  136.  
  137. This chapter gives you an example how to use Printfiles.
  138.  
  139.      Step 1 . Turn your printer on.
  140.      Step 2 . Doubleclick the Printfies icon or type
  141.               'PrintFiles'[return] into a shell window
  142.      Step 3 . Now you have an additional printer icon  on the
  143.               Workbench
  144.      Step 4 . Drag the icon of this .doc File on the Printer icon
  145.               and it will be printed.
  146.      Step 5 . Open the control window by double-clicking on the
  147.               printer icon.
  148.      Step 6 . Now You see the control window with the print list in
  149.               the center of the window
  150.      Step 7 . Drag more icons on the printer icon or into the control
  151.               window to insert them into the print list. you can also
  152.               insert files by typing the names into the StringGadget under
  153.               the list. To select files from a Filerequester click the
  154.               Request-Button.
  155.      Step 8 . Select some buttons, e.g. Date,Time ...
  156.      Step 9 . Click the Print-button and the whole list will be printed.
  157.      Step 10. After the print select the quit-button or the Close-Gadget
  158.               of the window. A requester will appear.
  159.      Step 11. Select the quit-button of the Requester.
  160.  
  161.  
  162. *********************************************************************
  163. *                     4. How to use Printfiles                      *
  164. *********************************************************************
  165.  
  166. The main Element in PrintFiles is the print list. The main operation
  167. in PrintFiles is to insert filenames into this list and print a  list.
  168. You can insert names in several ways: At Startup by the commandline or
  169. selected icons, by dragging icons onto the printer icon or into the
  170. control window, by using FileRequster or the Arexx-Port.
  171. Filenames can be passed to other programs (sorted by the Type of the File)
  172. You can e.g. pass an IFF-ILBM File to a display program or execute script
  173. files by dragging their icon onto the printer icon.
  174.  
  175. 4.1 The printer icon
  176.     PrintFiles adds a printer icon to the workbench. You can insert
  177.     files by dragging icons onto the printer icon.
  178.     If the control window is closed, this files are printed immediately.
  179.     If the window is open, they are added at the end of the list.
  180.  
  181. 4.2 The control window
  182.     This window contains all settings for the printer. It can be opened
  183.     or closed as you like and it remembers its position on re-opening.
  184.     NOTE: If you use a NTSC-machine check chapter 2.1 !
  185.  
  186.     4.2.1 Opening the control window
  187.           The window is normally closed at startup. You can open it
  188.           a. at startup  (see also chapter 6)
  189.              - from CLI/Shell by using option -w.
  190.              - from Workbench by using the TOOL TYPE
  191.                WINDOW=<left edge><top edge>.
  192.  
  193.           b. at runtime
  194.              - by double-clicking on the printer icon.
  195.              - by selecting the Item 'Printfiles' in the
  196.                Workbench-Tool-Menu.
  197.              - by sending the command 'openwindow control <left edge><top edge>'
  198.                to the Arexx-Port of Printfiles. (see also chapter 5)
  199.  
  200.     4.2.2 Closing the control window
  201.           - Double-click on the printer icon
  202.           - Select the Item 'Printfiles' in the Workbench-Tool-Menu.
  203.           - Send the command 'closewindow control' to the Arexx-Port of Printfiles.
  204.             (see also chapter 5)
  205.  
  206. *********************************************************************
  207. *                          5. Settings                              *
  208. *********************************************************************
  209.  
  210. The setting of the control window are ( top down ):
  211.  
  212.       -Prefs
  213.         AREXX    : openwindow prefs <LeftEdge><TopEdge>
  214.         opens the printer preferences window at <leftedge><topedge>
  215.       -filehandler
  216.         AREXX    : openwindow handler <leftedge><topedge>
  217.         opens the filehandler window
  218.          -Replace
  219.         AREXX    : openwindow replace <leftedge><topedge>
  220.         opens the replace window
  221.  
  222.       -about
  223.         AREXX    : version
  224.         Displays a requester containing the version number
  225.  
  226.       -Button date/Time/File
  227.         AREXX    : date on/off
  228.                    time on/off
  229.                    file on/off
  230.         CLI      : -d -t -n
  231.         TOOL TYPE: FLAGS=d FLAGS=t FLAGS=n
  232.         If one of these buttons is checked,  additional headline with
  233.         the requested information is generated.
  234.  
  235.        -Stringgadget headline/footline
  236.         AREXX    : headline  [...] sets headline  string
  237.                    footline [...] sets footline string
  238.         TOOL TYPE: headline=[...] footline=[...]
  239.         If a string is set, it will be printed on the top/foot of each
  240.         page.
  241.  
  242.        -Pagenumbers
  243.         AREXX    : page on/off
  244.         CLI      : -p
  245.         TOOL TYPE: FLAG=p
  246.         If checked, the string *** Page: xxxxx *** will be printed
  247.         on the foot of each page. Additionally, at the end of a file
  248.         the count of pages of this file is printed.
  249.  
  250.        -LineNumbers
  251.         AREXX    : line on/off
  252.         CLI      : -l
  253.         TOOL TYPE: FLAGS=l
  254.         If checked, each line will have a number.
  255.  
  256.        -FF/Page
  257.         AREXX    : fpage
  258.         CLI      : -c
  259.         TOOL TYPE: FLAGS=c
  260.         If checked, printfiles generates a form feed after each page.
  261.  
  262.        -Form Feed
  263.         AREXX    : ff on/off
  264.         CLI      : -f
  265.         TOOL TYPE: FLAGS=f
  266.         If checked, a Form Feed is printed after each file.
  267.  
  268.        -Replace
  269.         AREXX    : replace on/off
  270.         if checked, text replace commands in the file are executed
  271.         
  272.        -File List
  273.         Displays the current file list.
  274.         Every file in the list may have its own printer preferences;
  275.         these are the current (visible) settings of the Control window
  276.         (and the printer related parts of the prefs window) as they are when
  277.         you insert the file into the list.
  278.         If you want to edit the settings of a certain file, click onto its
  279.         name in the file list and the settings of that file become the current
  280.         settings. You may now change them and re-insert the file by activating
  281.         the string gadget that holds the name and pressing the ENTER button on
  282.         the keyboard.
  283.         NOTE: If you don't re-insert the file, the changes will not be
  284.               executed.
  285.        -Request
  286.         Displays a FileRequester and adds the choosen file to
  287.         the list.
  288.  
  289.        -Remove
  290.         AREXX    : remfile  remfile <File>
  291.         If you click onto a filename in the list, this file will be
  292.         displayed in the stringgadget beneath the remove-button.
  293.         If you then click this button, the file is removed from the
  294.         list. If the stringgadgets contains no name, the last file
  295.         of the list is removed.
  296.  
  297.        -Print
  298.         AREXX    : print
  299.         Begins printing the list. While Printing, this gadget is disabled.
  300.         You can perform all other functions like adding files, removing
  301.         files and so on. All changes are immediately recognized.
  302.         NOTE: It depends on the size of the printer buffer how fast the
  303.               changes will appear on the paper !
  304.  
  305.        -Quit  (and CloseGadget of the window)
  306.         AREXX    : quit
  307.         If the program is currently printing it will request you to abort
  308.         or continue the print.
  309.         If the program is not printing it will request you to quit the
  310.         program or to close the window (see chapter 4.2.1 and 4.2.2)
  311.         NOTE: the Arexx command will not display a requester !
  312.  
  313. 4.3. The Prefs Window
  314.  
  315.   4.3.2 Opening the prefs window
  316.         - click the 'Prefs' button in the control window
  317.         - send the 'openwindow prefs <Leftedge><TopEdge>' command to
  318.           the Arexx-Port.
  319.   4.3.3 Closing the prefs window
  320.         - click the closegadget of the prefs window
  321.         - send the 'closewindow prefs' command to
  322.           the Arexx-Port.
  323.   4.3.3 Settings of the prefs Window
  324.  
  325.         -button Draft/Lq
  326.          AREXX     : draft
  327.                      lq
  328.          TOOL TYPE : FLAGS=a
  329.                      FLAGS=q
  330.          CLI       : -a -q
  331.          Set the print quality to draft or lq
  332.  
  333.         -button 6 lines/inch  8 lines/inch.
  334.          AREXX     : 6li
  335.                      6li
  336.          TOOL TYPE : FLAGS=6
  337.                      FLAGS=8
  338.          CLI       : -6 -8
  339.          Set the spacing to 1/6 inch or 1/8 inch.
  340.  
  341.         -button 10cpi/12cpi/15cpi
  342.          AREXX     : 10cpi
  343.                      12cpi
  344.                      15cpi
  345.          TOOL TYPE : FLAGS=0
  346.                      FLAGS=2
  347.                      FLAGS=5
  348.          CLI       : -0 -2 -5
  349.          Set the pitch to Normal (10cpi) / Elite (12cpi) / condensed (15cpi).
  350.  
  351.         -stringgadget Lines/page
  352.          AREXX     : lines <number>
  353.          TOOL TYPE : LINES=<number>
  354.          Print <number> lines on each page.
  355.  
  356.         -stringgadget Left Margin
  357.          AREXX     : lmargin <number>
  358.          TOOL TYPE : LMARGIN=<number>
  359.          Set the left margin to column <number>
  360.  
  361.         -stringgadget Right Margin
  362.          AREXX     : rmargin <number>
  363.          TOOL TYPE : RMARGIN=<number>
  364.          Set the right margin to column <number>
  365.  
  366.         -button Print
  367.          same as Print-button in the control window.
  368.  
  369.        --------------------------------------------------
  370.        the following gadgets are to choose, which information
  371.        will be saved as an Arexx-Script.
  372.        the flags are for the saveprefs-command (in the Arexx-chapter)
  373.        --------------------------------------------------
  374.        - Comments   adds comments to the arexx script
  375.                     flag : '-c' turns this option on
  376.                     flag : '-C' turns this option off
  377.        - Files      adds the filenames of the print list
  378.                     flag : '-f' on
  379.                     flag : '-F' off
  380.        - Windows    adds openwindow commands for all windows
  381.                     flag : '-w' on
  382.                     flag : '-W' off
  383.        - Start      adds a startup code which tries to launch the
  384.                     PrintFiles program if it isn't already running
  385.                     flag : '-s' on
  386.                     flag : '-S' off
  387.        - Reset      adds a Reset command
  388.                     flag : '-r' on
  389.                     flag : '-R' off
  390.        - Print      adds a print command
  391.                     flag : '-p' on
  392.                     flag : '-P' off
  393.        - Icon       saves an Icon
  394.                     flag : '-i' on
  395.                     flag : '-I' off
  396.        - Printer    saves the settings of the control window (except the
  397.                     file list), the print Quality, the lines/inch, the
  398.                     CPI, and margin settings of the prefs window.
  399.                     NOTE: the Head- and Footline will not be saved
  400.                     until the H/F Arexx button is checked.
  401.                     flag : '-d' on
  402.                     flag : '-D' off
  403.        - Handler    saves the settings of the FileHandler window
  404.                     flag : '-h' on
  405.                     flag : '-H' off
  406.        - Extras & AREXX
  407.                      saves the settings of the ARexx-buttons and
  408.                      the default paths of the File- and SaveRequester
  409.                      flag : '-e' on
  410.                      flag : '-E' off
  411.  
  412.        - Head/Footline   saves the current Head/Footline
  413.                     NOTE: only if the 'Printer' button (AREXX-button)
  414.                           is checked.
  415.                     flag : '-l' on
  416.                     flag : '-L' off
  417.        - Printer
  418.        --------------------------------------------------
  419.  
  420.         -button Save
  421.          AREXX     : saveprefs <filename> <-flags>
  422.          Saves the current setting  as an Arexx-Script.
  423.          flags are (see above)
  424.          -cfwsrpildeh
  425.  
  426. 4.4 the Filehandler Window
  427.     4.4.1. Open the filehandler window
  428.            - select the Item 'Printfiles Filehandler window' in the
  429.              Workbench-Tool-Menu.
  430.            - press the button 'FileHandler' in the control window.
  431.            - send the command 'openwindow handler <left edge><top edge>'
  432.              to the Arexx-Port of Printfiles.
  433.  
  434.     4.4.2 Closing the control window
  435.           - Select the Item 'Printfiles filehandler window' in the Workbench-Tool-Menu.
  436.           - Send the command 'closewindow handler ' to the Arexx-Port of Printfiles.
  437.  
  438.     4.4.3 The settings of the Filehandler window
  439.  
  440.         - The Files (of the print list) are divided into 4 groups:
  441.           - text
  442.           - icon
  443.           - prog
  444.           - iff
  445.           Each of these groups has a button 'Intern' and 'To Program->' and
  446.           a corresponding command line.
  447.  
  448.           'Intern' means that a file of the corresponding type will be
  449.                    processed by the PrintFiles program.
  450.           'To Program->' means that a command line is build from the
  451.                    string gadget content followed by the name of the file.
  452.                    This command line will be passed to the Shell.
  453.  
  454.           Example: Imagine that you have a text files 's:startup-sequence' in
  455.                    your print list. If text is 'Intern' this file will be
  456.                    printed out using the control- and prefs window settings.
  457.                    If text is 'To Program->' and the command line contains
  458.                    'type >con:0/0/640/200/PrintFiles/AUTO/WAIT/CLOSE'
  459.                    this file (and all other text files) will be printed into
  460.                    a console window on the screen.
  461.  
  462.           Since IFF-Files can be of different types (ILBM,ANIM...)you can
  463.           have a command line for every IFF-type.
  464.           These lines are kept in the IFF-ID list.
  465.  
  466.           Example: Imagine that you have a file 'work:dpaint/picture/KingTut.ham'
  467.           in the print list. If IFF is 'Intern', the file is (yet) igonred.
  468.           If IFF is 'To Program->' and the IFF-ID List contains the line
  469.           'ILBM sys:utilities/display' the file (and all other IFF-ILBM Files)
  470.           is passed to the display program which will show the picture on the
  471.           screen. (got a graphics print program ?)
  472.           You can insert any IFF Form Chunk into this list, e.g
  473.           - 8SVX for sample voices
  474.           - ANIM for animations
  475.           - VDEO for Deluxe-Video animations
  476.           and so on ...
  477.  
  478.         - Output Printer/File
  479.  
  480.           Select Output to Printer or to a file which name is built from the
  481.           name in the string gadget followed by an index number
  482.           Example: if you have selected the output file name t:prf, the printed
  483.           files will be named t:prf.0, t:prf.1, t:prf.2 ...
  484.  
  485. 4.5. The Replace Window
  486.  
  487.   4.5.2 Opening the replace window
  488.         - click the (upper) 'Replace' button in the control window
  489.         - send the 'openwindow replace <Leftedge><TopEdge>' command to
  490.           the Arexx-Port.
  491.   4.5.3 Closing the replace window
  492.         - click the closegadget of the replace window
  493.         - send the 'closewindow replace' command to
  494.           the Arexx-Port.
  495.   4.5.3 Settings of the replace Window
  496.         there are only 3 items in the replace window.
  497.         
  498.         - prefix
  499.                 
  500.         - command list
  501.  
  502.         - remove button
  503.         
  504.         this items are described in the chapter "Arexx-Port"
  505.         
  506.         - prefix
  507.         - insertreplace
  508.         - removereplace
  509.         
  510. *********************************************************************
  511. *                      5. The Arexx-Port                            *
  512. *********************************************************************
  513.  
  514. The Arexx-port of Printfiles is named 'PRINTFILES'
  515.  
  516. 5.1. Command summary
  517.  
  518.     - clear
  519.       Returns     : nothing
  520.       Arguments   : none
  521.       Clears the print list.
  522.  
  523.     - closewindow <control|prefs|handler|replace>
  524.       Returns     : nothing
  525.       Arguments   : control      // close control window
  526.                     prefs        // close prefs window
  527.                     handler      // close FileHandler window
  528.                     replace      // close the replace window
  529.       Closes the specified  window. If the window is currently closed, the
  530.       command is ignored.
  531.  
  532.  
  533.     - date <on><off>
  534.       Returns     : nothing
  535.       Arguments   : on or off
  536.       sets/clears the date-button
  537.  
  538.     - draft
  539.       Returns     : nothing
  540.       Arguments   : none
  541.       Sets the printer to draft mode.
  542.  
  543.     - file <on><off>
  544.       Returns     : nothing
  545.       Arguments   : on or off
  546.       sets/clears the filename-button.
  547.  
  548.     - ff <on><off>
  549.       Returns: none
  550.       Arguments   : on or off
  551.       sets/clears the FormFeed-button.
  552.  
  553.     - fpage <on><off>
  554.       Returns     : nothing
  555.       Arguments   : on or off
  556.       sets/clears the button FF/Page
  557.  
  558.     - footline <string>
  559.       Returns     : nothing
  560.       Arguments   : string
  561.       Sets the footline string.
  562.  
  563.     - headline <string>
  564.       Returns     : nothing
  565.       Arguments   : string
  566.       Sets the headline string.
  567.  
  568.     - header <on|off>
  569.       Returns     : nothing
  570.       Arguments   : on or off
  571.       determines whether control codes are sent to the printer or not
  572.  
  573.     - icon <none | text | image | all>
  574.       return      : nothing
  575.       Arguments   : string
  576.       determines the print mode for icons
  577.        none  : Icons are ignored
  578.        text  : print a text info (similar to the workbench info command)
  579.        image : print Image (if your printer is able to print graphics)
  580.        all   : print both text and image
  581.  
  582.     - insertiff <line>
  583.       Returns     : nothing
  584.       Arguments   : string
  585.       inserts a command line at the end of the IFF-ID List.
  586.       e.g. insertiff 'ILBM sys:utilties/display'
  587.  
  588.     - insertreplace <command> <replace>
  589.       returns     : nothing
  590.       Arguments   : strings
  591.       NOTE: see also the 'replace' command
  592.       defines a <command> and a <replacement string>. If the
  593.       <command> string is found in the file (and ->replace is on),
  594.       it will be removed and replaced by the <replacement string>
  595.       Note: all commands MUST start with the same character, which
  596.             determined by the 'prefix' Arexx-Command.
  597.             The command is always a single word with no white spaces, 
  598.             and the replacement is the string (can be more than a word)
  599.             that comes after the command word (separated by at least one
  600.             white space character).
  601.              
  602.       Example: prefix is '\' (Backslash) 
  603.                insertreplace 'command will be replaced'
  604.                
  605.                If your file contains the word \command (with backslash)
  606.                this word will be replaced by the string 'will be replaced'
  607.                (of course without the quotes).
  608.           
  609.       within a macro you can determine some special replacements, all of
  610.       which begin with an '_' (Underscore). This commands are case 
  611.       dependant !
  612.       
  613.                _PPage  evaluates to the current page number
  614.                _NPage  evaluates to the total number of pages
  615.                        of this file
  616.                        
  617.                        NOTE: this two commands are only useful in the
  618.                        head- or footline strings. Used within a file leads
  619.                        to unpredictable results!
  620.                  
  621.                _FFull  evaluates to the full filename (including path)
  622.                _FFile  evaluates to the filename
  623.                _FPath  evaluates to the pathname
  624.                
  625.                _Mon    evaluates to the month number (1..12)
  626.                _Day    evaluates to the day (1..31)
  627.                _Year   evaluates to the year (two digits, e.g. 93)
  628.                _MNameD monthname in german
  629.                _MNameE monthname in english
  630.                _MNameF monthname in french
  631.                _MNameS monthname in spanish
  632.                _WDayD  dayname in german
  633.                _WDayE  dayname in english
  634.                _WDayF  dayname in french
  635.                _WDayS  dayname in spanish
  636.                
  637.                _H24    hour (24-hour format)
  638.                _H12    hour (12-hour format)
  639.                _AP     evaluates to 'AM' or 'PM' depending on the time
  640.                _Min    minute
  641.                _Sec    second 
  642.                
  643.                        NOTE: the macros concerning the time are
  644.                        evaluated during printing.
  645.               
  646.                _ESC    evaluates to the ESC character
  647.                _CTRL<x>evaluates to control character number <x>
  648.                        _CTRL27 = _ESC
  649.                        _CTRL32 = white space character
  650.                        NOTE: Do not use _CTRL0, use _NULL instead
  651.                _NULL   Null Byte
  652.                
  653.                         
  654.       Examples:
  655.            
  656.            1: assume the prefix is '\' (Backslash) and a command is
  657.               'date WDayE ,_MNameE _Day, 19_Year at _H12:_Min:_Sec _AP'
  658.               
  659.               then every occurence of the command \date in your file
  660.               will evaluate to the date and time of printing, for
  661.               example
  662.                    
  663.                      Sunday, April 11, 1993 at 1:30:00 PM
  664.               
  665.               when you are printing the file at this time.
  666.               
  667.            2: To set your printer to proportional spacing (if it
  668.               supports this) make two commands
  669.               
  670.               'prop_on  _ESC[2p'
  671.               'prop_off _ESC[1p'  
  672.               
  673.               and type the commands \prop_on and \prop_off into your
  674.               files wherever you want. These commands are then replaced
  675.               into the invisible control codes. 
  676.               Note: the control codes in this example are codes that are
  677.               interpreted by the printer device itself. Note that
  678.               the printer device cuts out codes that it doesn't 
  679.               understand. So if you have to send such codes, use the
  680.               printer device command which sends a number of bytes
  681.               unchanged to the printer.
  682.               
  683.               Example: Set an EpsonLQ printer to script typeface
  684.               
  685.                        'script _ESC[3"r_ESCk_CTRL1'
  686.                                 
  687.                        in which _ESC[3"r is the command that 
  688.                        passes the next 3 bytes unchanged to the
  689.                        printer.
  690.                        To reset to the normal (roman) typeface, use
  691.                        
  692.                        'roman _ESC[3"r_ESCk_NULL'
  693.                        
  694.                        Note that _NULL is used to send a null byte to
  695.                        the printer.
  696.                        
  697.     - insfile <filename>
  698.       Returns     : nothing
  699.       Arguments   : filename
  700.       Adds the <filename> to the print list
  701.  
  702.     - line <on><off>
  703.       Returns     : nothing
  704.       Arguments   : on or off
  705.       sets/clears the LineNumber-button.
  706.  
  707.     - lines <zahl>
  708.       Returns     : nothing
  709.       Arguments   : number
  710.       <number> lines per page will be printed.
  711.  
  712.     - lmargin <number>
  713.       Returns     : nothing
  714.       Arguments   : number
  715.       Sets the left  margin to column #<number>
  716.  
  717.     - lq
  718.       Returns     : nothing
  719.       Arguments   : none
  720.       Sets the printer to NLQ mode.
  721.  
  722.     - openwindow <control|prefs|handler|replace> <left edge> <top edge>
  723.       Returns     : nothing
  724.       Arguments   : <which> control  //open the control window
  725.                             prefs    //open the prefs window
  726.                             handler  //open the Filehandler window
  727.                             replace  //open the replace window
  728.                     <left>  number
  729.                     <right> number
  730.       Opens the specified  window at <left edge> <top edge>.
  731.       If the edges doesn't fit on the screen the window
  732.       will be adjusted, e.g. 'openwindow control 10000 10000' will
  733.       place the window in the right bottom edge of the screen.
  734.       If no numbers are given, the window will be opened on
  735.       the position where it was closed.
  736.       if the window is already open, the command is ignored.
  737.  
  738.     - output <printer | <filename>>
  739.       Returns     : nothing
  740.       Arguments   : keyword printer or a filename
  741.       sends the output to the printer or into the file <filename>
  742.  
  743.     - page <on><off>
  744.       Returns     : nothing
  745.       Arguments   : on or off
  746.       sets/clears the Pagenumber-button.
  747.  
  748.     - pass <text | prog | icon | iff> <intern | on | <line>>
  749.       Returns     : nothing
  750.       Arguments   : keywords text,prog,icon,iff,intern,on
  751.                     string line
  752.  
  753.       passes filenames of a given type to other programs
  754.       Examples:
  755.                'pass text intern' : text files are processed by the
  756.                                     PrintFiles program.
  757.                'pass text on'     : a command line is build from
  758.                                     the (existing) line and the filename.
  759.                                     the command line is then passed
  760.                                     to the shell.
  761.                'pass text type >con:0/0/640/200/Printfiles/AUTO/WAIT/CLOSE'
  762.                                   : a command line is build and text files
  763.                                     will be passed to the shell using this
  764.                                     line.
  765.  
  766.       Note: the IFF button allows only the keywords 'intern' and 'on'
  767.             Connections to other files are build using the IFF-ID List.
  768.  
  769.     - prefix <character>
  770.       Returns     : nothing
  771.       Arguments   : single character
  772.       determines the single character that introduces a text
  773.       replace command. Default is '\' (Backslash). For performance
  774.       reasons, use a character that does appear only as a prefix
  775.       in your files.
  776.  
  777.     - print
  778.       Returns     : nothing
  779.       Arguments   : none
  780.       Starts printing the list.
  781.  
  782.     - prog <none | text | icon | all>
  783.       return      : nothing
  784.       Arguments   : string
  785.       determines the print mode for program files
  786.        none : ignore programs
  787.        text : print a TextInfo (similar to the shell command list)
  788.        icon : print the icon (if the program has one) in the selected print
  789.               mode for icons.
  790.        all  : print both text and icon
  791.  
  792.     - remfile <filename>
  793.       Returns: "NOT-IN-LIST"     if the filename isn't in the list
  794.                "LIST_EMPTY"      if the list was empty
  795.                ""                o.k.
  796.       Arguments   : filename
  797.       Removes the file <filename> from the list.
  798.       if no filename is given the last file of the list is removed.
  799.  
  800.     - removeiff <line>
  801.       Returns     : nothing
  802.       Arguments   : string
  803.       deletes a command line from the IFF-ID List.
  804.       e.g. removeiff 'ILBM sys:utilties/display'
  805.       if no line is given, the last item of the list is deleted.
  806.     
  807.     - removereplace <command>
  808.       Returns     : nothing
  809.       Arguments   : string
  810.       removes the <command> from the text replace list
  811.       
  812.     - replace <on><off>
  813.       Returns      : nothing
  814.       Arguments   : on or off
  815.       if replace is 'on' the file is searched for commands to
  816.       replace, if replace is 'off', even text replacement commands
  817.       fo unchanged to the printer.
  818.       
  819.     - replyport <portname>
  820.       Returns     : nothing
  821.       Arguments   : string
  822.       Every time a list is fully printed, the port with the name
  823.       <portname> is signaled. 
  824.       NOTE: it is important to reply the message immediately without
  825.             examining it; it contains no valid data !.
  826.  
  827.     - reset
  828.       Returns     : nothing
  829.       Arguments   : none
  830.       Clears all buttons, clears the list and sets the printer to
  831.       draft mode.
  832.  
  833.     - rmargin <number>
  834.       Returns     : nothing
  835.       Arguments   : number
  836.       Sets the right margin to column #<number>
  837.  
  838.     - saveprefs <filename> <-flags>
  839.       Returns     : nothing
  840.       Arguments   : strings
  841.       if a filename is given, the current settings are saved as
  842.       an Arexx-script.
  843.       The flags are described in -chapter 4.3.3 Save-
  844.  
  845.     - status
  846.       Returns     : "PRINTING" if Printfiles is currently printing
  847.                     "WAITING"  if PrintFiles isn't printing
  848.       Arguments   : none
  849.  
  850.     - time <on><off>
  851.       Returns: none
  852.       Arguments   : on or off
  853.       sets/clears the time-button.
  854.  
  855.  
  856.     - quit
  857.       Returns     : nothing
  858.       Arguments   : none
  859.       if PrintFiles is currently printing, the print will be aborted.
  860.       if PrintFiles isn't printing, the program will be quit.
  861.       NOTE: No requesters are displayed !
  862.  
  863.     - version
  864.       Returns     : Version string  (e.g. "Version 0.9e")
  865.       Arguments   : none
  866.  
  867. *********************************************************************
  868. *                     6. The spooler directory                      *
  869. *********************************************************************
  870.  
  871. 6.1 Usage
  872.  
  873.     At startup, PrintFiles creates a directory ram:printer and gives it
  874.     the device name PRINTER:
  875.     All files that are copied into this directory will be inserted into
  876.     the print list. If the control window is closed, the list will be printed.
  877.  
  878.     **********************************************************************
  879.     CAUTION- CAUTION- CAUTION- CAUTION- CAUTION- CAUTION- CAUTION- CAUTION
  880.  
  881.     After they are printed, the
  882.  
  883.                            F I L E S
  884.  
  885.     in the PRINTER: directory
  886.  
  887.                  W I L L    B E   D E L E T E D !!!!
  888.  
  889.     If you re-assign the name PRINTER: to an existing directory, the files in it
  890.     will be lost !!!
  891.  
  892.     IT IS STRONGLY RECOMMENDED THAT YOU DO NOT RE-ASSIGN THE NAME PRINTER: TO ANY
  893.     OTHER DIRECTORY THAN THE RAM:PRINTER DIRECTORY WHICH IS CREATED BY PRINTFILES !!!
  894.  
  895.     CAUTION- CAUTION- CAUTION- CAUTION- CAUTION- CAUTION- CAUTION- CAUTION
  896.     **********************************************************************
  897.  
  898.     When you quit PrintFiles, the PRINTER: directory is scanned for new files.
  899.     If there are any, they will be printed out before quitting.
  900.  
  901.  
  902. *********************************************************************
  903. *                   7. Starting PrintFiles                          *
  904. *********************************************************************
  905.  
  906. Printfiles loads the file s:printfiles.config at startup. This is a plain
  907. ascii file containing valid PrintFiles Arexx-Commands. It can (and should)
  908. be file generated by PrintFiles itself via the ->saveprevs command.
  909.  
  910. 7.1. Usage from Shell/CLI
  911.      printfiles -<flags> file file  ....
  912.      There is no need to 'run' Printfiles.
  913.  
  914.      The following flags are supported:
  915.  
  916.      -t sets the time-button
  917.      -f sets the formfeed-button
  918.      -n sets the filename-button
  919.      -d sets the date-button
  920.      -p sets the pagenumber-button
  921.      -l sets the linenumber-button
  922.      -c sets the CR/LF-button
  923.      -a sets the draft-button (Default)
  924.      -q sets the NLQ-button
  925.      -w open the control window at startup
  926.      -0\
  927.      -2 > set the print pitch to 10cpi/12cpi/15cpi
  928.      -5/
  929.      -6\
  930.      -8/  set the spacing to 1/6 inch or 1/8 inch
  931.  
  932.      The flags can be given as single (e.g. printfiles -w -p -f)
  933.      or grouped (e.g. printfiles -wpf)
  934.  
  935.      All names without hyphen are treated as filenames and are
  936.      added to the print list. If you have specified filenames on
  937.      the command line, they will be printed immediately after
  938.      startup.
  939.  
  940. 7.2. Usage from Workbench
  941.  
  942.      TOOLTYPES
  943.      Tool types can consist of all valid PrintFiles Arexx-commands,
  944.      e.g. headline 'test headline' , page on ...
  945.      They must be typed into the TOOLTYPE array in the syntax similar to
  946.      the Printfiles-generated Arexx-files.
  947.      NOTE: This is not the standard syntax for TOOLTYPES !
  948.  
  949.      You can add files to the list by extended selection with the
  950.      program icon and file icons.
  951.      All selected files are added to the print list and will be
  952.      printed immediately after startup.
  953.  
  954.  
  955. *********************************************************************
  956. *                         8. Notes                                  *
  957. *********************************************************************
  958.  
  959. PrintFiles is Copyright ©1992 K.Klingbeil, All Rights Reserved. There
  960. are 2 Versions, 1.4d in german and 1.4e in english.
  961. Printfiles first was programmed with SAS/C 5.10b on an A2000/68030 with
  962. 1 MB chip memory, 4MB fast memory and A2091 SCSI-Controller with Quantum
  963. LPS40 under OS 2.04 (Kick 37.175).
  964.  
  965. For version 1.4 SAS/C 6.0 was used on an Amiga 4000/68040 25 MHZ,2MB chip,
  966. 4MB fast memory under Kickstart 39.106, Workbench 39.29. 
  967. Bug reports,  suggestions, criticism, money, jewellery and other gifts
  968. to
  969.  
  970.  
  971.                          Karlheinz Klingbeil
  972.                          Elzstr. 42
  973.  
  974.                          W-7809 Gutach
  975.                          Federal Republic of Germany
  976.  
  977.  
  978. And now: Enjoy !!!
  979.  
  980. *********************************************************************
  981.  
  982.  
  983.