home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / columns-2.6.lha / Columns / Columns.doc < prev    next >
Text File  |  1993-12-21  |  12KB  |  307 lines
  1.  
  2.  **************************************************************************** 
  3. ******************************************************************************
  4. **                                                                          **
  5. **                               Columns 2.6                                **
  6. **                                                                          **
  7. **                         The Paper Saving Utility                         **
  8. **                                                                          **
  9. **                                                                          **
  10. **                     (c) 1993 MJSoft System Software                      **
  11. **                                                                          **
  12. **                                    -                                     **
  13. **                                                                          **
  14. **                              Martin  Mares                               **
  15. **                                                                          **
  16. **                                   and                                    **
  17. **                                                                          **
  18. **                              Tomas Zikmund                               **
  19. **                                                                          **
  20. ******************************************************************************
  21.  **************************************************************************** 
  22.  
  23.  
  24.    CONTENTS:
  25.    ---------
  26.  
  27.   1. Preview
  28.   2. System requirements
  29.   3. How to start Columns
  30.   4. The main window
  31.   5. Action gadgets
  32.   6. String gadgets
  33.   7. Option gadgets
  34.   8. Remarks
  35.  
  36.  
  37. 1. Preview
  38. ----------
  39.  
  40.    This utility allows you to control your printer in the more efficient way -
  41. you can print the text in columns and use various compression modes (up to 160
  42. characters  per  line  and  180 lines per standard DIN A4 page - cca 5.6 times
  43. more characters than in usual modes, but still readable...).
  44.  
  45.    Main features:
  46.  
  47.      - Written completely in assembly
  48.  
  49.      - Kickstart 2.0 and 3.0 compatible
  50.  
  51.      - Kickstart 2.0 look
  52.  
  53.      - Keyboard controls
  54.  
  55.      - Saveable settings
  56.  
  57.  
  58.    COLUMNS and its documentation is Copyright (c) Martin Mares & Tomas
  59. Zikmund, MJSoft System Software, Prague, Czech Republic.
  60.  
  61.    This  archive  can be freely redistributed, as long as all of its files are
  62. included   in   their  original  form  without  any  additions,  deletions  or
  63. modifications, and no more than a nominal fee is charged for its distribution.
  64. All  copyright  notices  in  the programs and accompanying documentation files
  65. must  remain  on  their places.  Also '.displayme' and other similar files may
  66. not be added.  This is generally known as FREEWARE.
  67.  
  68.    Special  permission is given to Fred Fish to distribute this program on his
  69. "Fish Disks".
  70.  
  71.    This  software  is  provided  "AS IS" without warranty of any kind,  either
  72. expressed  or implied.  The author is not responsible for any damage caused by
  73. it.
  74.  
  75.  
  76. 2. System requirements
  77. ----------------------
  78.  
  79.    This program requires:
  80.  
  81.       - Kickstart 1.2 or higher
  82.  
  83.       - Arp.library
  84.  
  85.       - Req.library or reqtools.library (if both are available, reqtools will
  86.         be used)
  87.  
  88.  
  89. 3. How to start Columns
  90. -----------------------
  91.  
  92.    There are two ways to start Columns and pass it the parameters:
  93.  
  94.       - Start it from CLI
  95.  
  96.           - Parameter template: PRINT/S,FROM,TO,CFG/K
  97.  
  98.                - PRINT: start operation automatically without entering GUI.
  99.                         In this case, only the status window will appear
  100.                         and all error messages will be written to standard
  101.                         output.
  102.  
  103.                - FROM:  name of source file you want to process
  104.  
  105.                - TO:    name of destination file to store the result to
  106.  
  107.                - CFG:   name of configuration file to be used
  108.  
  109.             - You can start Columns in batch mode (the PRINT option) or only
  110.               fill in the filename gadgets.
  111.  
  112.             - You can use '?' for help, then '?' for more help (as in ARP
  113.               commands).
  114.  
  115.       - Start it from Workbench
  116.  
  117.             - you can start it simply by doubleclicking its icon.
  118.  
  119.             - you can specify input/output/configuration file name as the tool
  120.               types (FROM=,TO= and CFG=) - consult your Workbench manual how
  121.               to do it.
  122.  
  123.             - you can shift-doubleclick the source file you wish to use.
  124.  
  125.             - the source file passed by shift-doubleclick can also have tool
  126.               types, which will be used instead of the standard tool types.
  127.  
  128.             - it's also possible to set the default tool of some project to
  129.               Columns. This file will be used as the source file and its tool
  130.               types will be used.
  131.  
  132.  
  133. 4. The main window
  134. ------------------
  135.  
  136.    If  you  start  Columns, the main window will appear.  You can see a lot of
  137. gadgets and texts on it.  Let's explain them:
  138.  
  139.    In  the  top  left  corner of the window you can see three large boxes with
  140. small  gadgets named "FROM", "TO" and "CTAB" on the left.  These boxes display
  141. the  file  names  -  name of the source file, name of the destination file and
  142. name  of  the  conversion  table  file.   You  can select the file by the file
  143. requester if you click on the corresponding gadget.
  144.  
  145.    There are some relatively large gadgets in the top right corner.  There are
  146. named  "action  gadgets".   Each  of  these gadgets starts some process (other
  147. gadgets control only the parameters of the process).
  148.  
  149.    The  rest of the screen consists of the left half containing string gadgets
  150. with  many  settings (as the page width, page heights, tab size and so on) and
  151. the right half filled with switches.
  152.  
  153.  
  154. 5. Action gadgets
  155. -----------------
  156.  
  157.    CONVERT  -  start  text  processing from the input file to the output file.
  158. The  status  window  will be opened and will show status of the operation (see
  159. below).
  160.  
  161.    PRINT - start text processing from the input file to the printer.
  162.  
  163.    INFO  -  start  text  processing  from  the  input file without any output.
  164. Useful for determining the number of pages and similar parameters.
  165.  
  166.    SAVE  CONFIG  -  save  configuration.   The  default  configuration file is
  167. s:columns.def.   You  can  save the defaults into the current directory - they
  168. will  have  higher  priority.  It's also possible to save the defaults to some
  169. other  file and load it using the CFG option (or the CFG tool type).  The file
  170. requester will show you the name of the currently used default file.
  171.  
  172.    STD  SIZE - recalculate the page size from the standard page size according
  173. to the print mode.
  174.  
  175.    AUTO  COLUMN - determine optimal number of columns for selected input file.
  176. This  function  will  scan  the  file  and  will choose such minimal number of
  177. columns,  which  will produce minimal number of pages.  This value can be very
  178. suspicious  (can  you  imagine your assembler source in 13 columns?  but these
  179. can be really optimal if you take care only of the number of pages) and can be
  180. limited by the "SEARCH LIMIT" switch.
  181.  
  182.  
  183. 6. String gadgets
  184. -----------------
  185.  
  186.    Page width - width of the current page in the current mode (in characters).
  187.    Page height - height of the current page in the current mode (in lines).
  188.      - these two values are usually not entered by the user, because it's
  189.        better to select the standard page dimensions and use the STD SIZE
  190.        command.
  191.  
  192.    Tab size - size of the tab (in characters).
  193.  
  194.    Column width - width of the column.
  195.    Number of columns - number of columns across the page.
  196.      - you can enter one of these values (will be marked by the "«" sign) and
  197.        Columns will calculate the correct value of the other parameter.
  198.  
  199.    Std page X & Y - dimensions of the page in standard font (with all the font
  200.      switches switched off). This page is used as the base for the STD SIZE
  201.      command.
  202.  
  203.    Number of the 1st page - this value will be used as the number of the first
  204.      page (for example: you can start the page numbers with 7 if you have six
  205.      pages to use t