home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d900 / columns.lha / Columns / Columns.doc < prev    next >
Text File  |  1993-07-24  |  11KB  |  294 lines
  1.  
  2.  **************************************************************************** 
  3. ******************************************************************************
  4. **                                                                          **
  5. **                               Columns 2.5                                **
  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.             - you can specify the names of source, destination and
  97.               configuration file as the parameters, but you needn't.
  98.  
  99.             - you can use '?' for help, then '?' for more help (as in ARP
  100.               commands).
  101.  
  102.       - Start it from Workbench
  103.  
  104.             - you can start it simply by doubleclicking its icon.
  105.  
  106.             - you can specify input/output/configuration file name as the tool
  107.               types (FROM=,TO= and CFG=) - consult your Workbench manual how
  108.               to do it.
  109.  
  110.             - you can shift-doubleclick the source file you wish to use.
  111.  
  112.             - the source file passed by shift-doubleclick can also have tool
  113.               types, which will be used instead of the standard tool types.
  114.  
  115.             - it's also possible to set the default tool of some project to
  116.               Columns. This file will be used as the source file and its tool
  117.               types will be used.
  118.  
  119.  
  120. 4. The main window
  121. ------------------
  122.  
  123.    If  you  start  Columns, the main window will appear.  You can see a lot of
  124. gadgets and texts on it.  Let's explain them:
  125.  
  126.    In  the  top  left  corner of the window you can see three large boxes with
  127. small  gadgets named "FROM", "TO" and "CTAB" on the left.  These boxes display
  128. the  file  names  -  name of the source file, name of the destination file and
  129. name  of  the  conversion  table  file.   You  can select the file by the file
  130. requester if you click on the corresponding gadget.
  131.  
  132.    There are some relatively large gadgets in the top right corner.  There are
  133. named  "action  gadgets".   Each  of  these gadgets starts some process (other
  134. gadgets control only the parameters of the process).
  135.  
  136.    The  rest of the screen consists of the left half containing string gadgets
  137. with  many  settings (as the page width, page heights, tab size and so on) and
  138. the right half filled with switches.
  139.  
  140.  
  141. 5. Action gadgets
  142. -----------------
  143.  
  144.    CONVERT  -  start  text  processing from the input file to the output file.
  145. The  status  window  will be opened and will show status of the operation (see
  146. below).
  147.  
  148.    PRINT - start text processing from the input file to the printer.
  149.  
  150.    INFO  -  start  text  processing  from  the  input file without any output.
  151. Useful for determining the number of pages and similar parameters.
  152.  
  153.    SAVE  CONFIG  -  save  configuration.   The  default  configuration file is
  154. s:columns.def.   You  can  save the defaults into the current directory - they
  155. will  have  higher  priority.  It's also possible to save the defaults to some
  156. other  file and load it using the CFG option (or the CFG tool type).  The file
  157. requester will show you the name of the currently used default file.
  158.  
  159.    STD  SIZE - recalculate the page size from the standard page size according
  160. to the print mode.
  161.  
  162.    AUTO  COLUMN - determine optimal number of columns for selected input file.
  163. This  function  will  scan  the  file  and  will choose such minimal number of
  164. columns,  which  will produce minimal number of pages.  This value can be very
  165. suspicious  (can  you  imagine your assembler source in 13 columns?  but these
  166. can be really optimal if you take care only of the number of pages) and can be
  167. limited by the "SEARCH LIMIT" switch.
  168.  
  169.  
  170. 6. String gadgets
  171. -----------------
  172.  
  173.    Page width - width of the current page in the current mode (in characters).
  174.    Page height - height of the current page in the current mode (in lines).
  175.      - these two values are usually not entered by the user, because it's
  176.        better to select the standard page dimensions and use the STD SIZE
  177.        command.
  178.  
  179.    Tab size - size of the tab (in characters).
  180.  
  181.    Column width - width of the column.
  182.    Number of columns - number of columns across the page.
  183.      - you can enter one of these values (will be marked by the "«" sign) and
  184.        Columns will calculate the correct value of the other parameter.
  185.  
  186.    Std page X & Y - dimensions of the page in standard font (with all the font
  187.      switches switched off). This page is used as the base for the STD SIZE
  188.      command.
  189.  
  190.    Number of the 1st page - this value will be used as the number of the first
  191.      page (for example: you can start the page numbers with 7 if you have six
  192.      pages to use them as first six).
  193.  
  194.    Page header - this string will be used as the header of each page if you
  195.      turn the HEAD switch on. The percent sign ("%") followed by one character
  196.      will be replaced by some special string:
  197.  
  198.            %s - partial file name (without full path)
  199.            %f - full file name
  200.            %p - page number
  201.            %d - current date
  202.            %t - current time
  203.  
  204.      The header will be centered automatically.
  205.  
  206.  
  207. 7. Option gadgets
  208. -----------------
  209.  
  210.    Control characters - selects which set of control characters you wish to use
  211.  
  212.          EPSON - use control characters for EPSON printers. In this mode, the
  213.                  PRINT command will not use the standard ANSI output via the
  214.                  printer.device, but the direct output via the parallel
  215.      or serial.device.
  216.  
  217.           ANSI - use standard ANSI control sequences usable for all printers.
  218.                  In this mode, the printer output will be done via the
  219.                  printer.device, but it doesn't support the SMALL mode.
  220.  
  221.           NONE - don't emit any control characters.
  222.  
  223.    Extraneous characters - selects what you wish to make with these
  224.      characters, which exceed the column margin
  225.  
  226.            CUT - remove them.
  227.  
  228.          RIGHT - place them on the right side of the next line (default).
  229.  
  230.           LEFT - place them on the left side of the next line.
  231.  
  232.    Print mode - specifies the font type
  233.  
  234.          ELITE and EPSON specify the width of the characters:
  235.  
  236.                                   ELITE     CONDENSED     CPI (chars per inch)
  237.  
  238.                  Epson printers   OFF       OFF           10
  239.                                   ON        OFF           12
  240.                                   OFF       ON            17
  241.                                   ON        ON            20
  242.  
  243.             some other printers   OFF       OFF           10
  244.                                   ON        OFF           12
  245.                                   OFF       ON            15
  246.                                   ON        ON            18
  247.  
  248.          SMALL - when used (doesn't work in the ANSI mode), the printer will
  249.                  double the number of lines of the page (allows 180 lines on
  250.                  the DIN A4 page).
  251.  
  252.    Quality - specifies the print quality - usually used when you have an old
  253.              ribbon in the printer.
  254.  
  255.            NLQ - use the Near Letter Quality mode.
  256.  
  257.           BOLD - print bold letters.
  258.  
  259.    Page formatting - defines format of the page
  260.  
  261.             FF - put form feeds after pages (if off, only line feeds are
  262.                  emitted).
  263.  
  264.           HEAD - use page header.
  265.  
  266.          LINES - separate the columns by vertical lines ('|').
  267.  
  268.          EPSON - use standard Epson dimensions of the font (see font switches).
  269.  
  270.           LNUM - generate line numbers before each line. The AUTO COLUMN
  271.                  function doesn't give reliable results in this mode.
  272.  
  273.    Character conversion - chooses the Character conversion mode. In this mode,
  274.       each character can converted to any other character using the conversion
  275.       table (see the file name boxes). Characters converted to 0x00 will be
  276.       ignored (use for example if you want to remove form feeds from your
  277.       document). The conversion tables can be simply edited by the CTED
  278.       program.
  279.  
  280.    Large buffer - forces Columns to load the whole file before processing it.
  281.       Normally, the file is read by the four-kilobyte parts. This options
  282.       speeds up loading from the disk, but uses more memory.
  283.  
  284.    Search limit - sets and enables the maximal number of columns for the AUTO
  285.       COLUMN function. Protects you against unusable (but really optimal)
  286.       results.
  287.  
  288.  
  289. 8. Final words
  290. --------------
  291.  
  292.    Send your comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz.
  293.  
  294.