home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / vrac / cols14.zip / README.TXT < prev    next >
Text File  |  1995-06-22  |  10KB  |  262 lines
  1.  
  2.                    The Text Column Architect
  3.                              COLS
  4.                  COPYRIGHT (C) 1995 CHUCK BERNT
  5.                        ALL RIGHTS RESERVED
  6.  
  7.  
  8.   This program changes the columns in a text file.
  9.  
  10.    *  The user can instantly evaluate and compare QBASIC expressions
  11.       right from the DOS command line.
  12.  
  13.    *  It can swap, add and delete columns in a text file.
  14.  
  15.    *  It can total and average (to the screen) any numeric column.
  16.  
  17.    *  It can calculate and insert any column that can be expressed 
  18.       as a QBASIC expression of the other columns (including 
  19.       logical expressions).
  20.  
  21.    *  Text may also be inserted.
  22.  
  23.    *  The columns can be defined (delimited) by white spaces, spaces,
  24.       tabs, commas or any ASCII character or groups of characters.
  25.  
  26.    *  There are no file length limits.
  27.  
  28.    *  It has a short cut command line form for power users.
  29.  
  30.    *  It can be interrupted at any time by typing CNTRL+BREAK.
  31.  
  32. ---------------------------------------------------------------------
  33.  
  34.   SHORT FORM OR COMMAND LINE FORM
  35.  
  36.  
  37.       SYNTAX: COLS FILENAME OUTPUTCOL1 [OUTPUTCOL2] ... [OUTPUTCOL8]
  38.  
  39.         WHERE:
  40.  
  41.            FILENAME is the input filespec without the extension
  42.             (.TXT is assumed).  The output filename will be the
  43.             same FILENAME with the extension .LIS
  44.  
  45.            OUTPUTCOL can be any of the following three formats.
  46.  
  47.              1. Any text preceded with a T.  The text will be placed
  48.                 in the respective output column (without the T) in
  49.                 every output line (no embedded spaces, commas, etc.
  50.                 in the short form).
  51.  
  52.              2. Any input column number.  The input column specified
  53.                 will be placed in that output column.
  54.  
  55.              3. Any valid QBASIC expression without spaces.  Use Cn
  56.                 to represent input column n.  For example C1
  57.                 represents input column one.  All expressions must
  58.                 contain at least one Cn or C.  If your expression
  59.                 is not a function of the input columns, then add C
  60.                 to it.  C is equal to zero.
  61.  
  62.  
  63.                          SOME EXAMPLES
  64.  
  65.                 COLS FUN 1 2 3 TSUM C1+C2+C3
  66.                 COLS FUN 1 TAVE (C1+C2+C3)/3
  67.                 COLS FUN 1 TSQUARE C1^2 tbig-one c1^c1
  68.                 COLS FUN 1 2^C1
  69.  
  70.                 I have included the file FUN.TXT so that you can
  71.                 checkout the above expressions (or any other
  72.                 expressions).  Go ahead and try them out but stay
  73.                 in the \cols directory for now (the last example
  74.                 will give you a power of two table).  FUN.TXT is
  75.                 also great for doing side by side comparisons of
  76.                 two expressions.
  77.  
  78.                 The program should have automatically started your
  79.                 text editor on the output file after it generated
  80.                 the file.  If it didn't start it or it didn't
  81.                 start your favorite DOS editor, go to the second
  82.                 to the last line of the batch file (COLS.BAT)
  83.                 and change the word EDIT to the name of your
  84.                 preferred DOS editor.
  85.  
  86.                 To repeat the last cols command line, just type
  87.                 "COLS L" or "COLS LAST" (the last command line
  88.                 used is stored on the disk).
  89.  
  90.  
  91.                SOME SHORT CUT DEFAULT VALUES AND LIMITATIONS
  92.  
  93.               (Use the long form to avoid these limitations or
  94.               you can make batch program adjustments to these
  95.               default values.)
  96.  
  97.              1. You may use only legal command line text.  No
  98.                 embedded spaces, commas, equal signs, etc.
  99.  
  100.              2. The input files' column delimiter is set to be
  101.                 any number of white spaces in the short form.
  102.  
  103.              3. Input file checking is defaulted to "no" in
  104.                 the short form.
  105.  
  106.              4. Interim status reports are not available in
  107.                 the short form.
  108.  
  109.              5. You are limited to eight output columns in
  110.                 the short form.
  111.  
  112. --------------------------------------------------------------------
  113.  
  114. LONG FORM
  115.  
  116. SYNTAX: COLS
  117.  
  118.    The program will ask you questions and then guide you.  The
  119.    automatic editor start is not available in the long form.  Go 
  120.    ahead and try it but stay in the \cols directory for now.
  121.  
  122.    Well, what do you think?  If you feel that you can use it, you can
  123.    make the COLS programs available from any directory on you drive.
  124.    Just type PATH at the DOS prompt and choose a directory that will
  125.    be around for a long time and COPY the COLS.BAT to that directory.
  126.    That's it.  That's all there is to it.
  127.  
  128.    Please type the directory path below so that you can change the
  129.    batch program if you need to later.
  130.  
  131. PATH TO COLS.BAT = 
  132.  
  133. --------------------------------------------------------------------
  134.  
  135. REGISTRATION OF THIS SHAREWARE
  136.  
  137.   COLS is offered as shareware and not freeware.  You
  138.   may use and evaluate this version of COLS for up to
  139.   30 days.  After this 30 day evaluation period, you must
  140.   either register COLS by filling out and mailing in
  141.   REGFORM.TXT or remove COLS (including the above COLS.BAT
  142.   command) from your hard disk.  You may keep it on
  143.   floppies or other storage media separate from your
  144.   computer as long as you do not use it.  The shareware
  145.   registration fee is only $5 per simultaneous user.
  146.   I am relying on the users' honesty and good will
  147.   to make this endeavor viable.
  148.  
  149.   If the response is favorable, I will develop a column-
  150.   row interchange program that would then allow control
  151.   of both rows and columns by the present COLS program.
  152.   I would then make that interchange program available
  153.   to those expressing an interest on the COLS REGFORM.
  154.  
  155.   Please feel free to pass on the program to friends,
  156.   but please pass on the COLS14.EXE file since it has
  157.   all the files your friends will need.  Please also
  158.   mention to place the COLS14.EXE in the \COLS directory
  159.   and to type COLS14 from that directory and then to
  160.   read this README.TXT file.  
  161.  
  162.    
  163.  
  164.   This program is written in QBASIC and will only work on machines
  165.   that have QBASIC (MS DOS versions later than 5.0).
  166.  
  167.  
  168.   If have questions, please contact me at one of the following
  169.   addresses.
  170.  
  171.                    Chuck Bernt
  172.                    22365 El Toro Rd., # 118
  173.                    El Toro, Ca. 92630
  174.                    U.S.A.
  175.  
  176.       Compuserve: 74761,3356
  177.         Internet: 74761.3356@COMPUSERVE.COM
  178.  
  179.  
  180.             Thank you for evaluating this software.
  181.  
  182.  
  183.   NOTES:
  184.  
  185.         1. When specifying an input column to place in an output
  186.            column, you may also use an expression to select the
  187.            input column.  For example 2, 1+1, 4/2 and 2^2-2 all
  188.            specify the second input column.  So be aware if you
  189.            forget to include a Cn or a C when you are creating a
  190.            column you may end up just copying an input column to
  191.            that output column.
  192.  
  193.         2. I have included the file FUNLOGIC.TXT so that you can
  194.            compare logic expressions side by side.  Unfortunately
  195.            QBASIC logic expressions normally use spaces to
  196.            to separate operators and variables.  Since the command
  197.            line does not allow spaces, the variables will need to
  198.            be enclosed in parentheses when the command line form is
  199.            used.  Qbasic uses false = 0 and true = -1.  This
  200.            creates another problem when trying to get the columns
  201.            to line up.  If the - in the output file is replaced with
  202.            nothing, then the output file columns will line up.  
  203.            If their is enough interest in logic expressions, I will
  204.            remove the - sign requirement in the input and output files.
  205.            You may want to check out the following logic expressions
  206.            at the command line.  Don't forget to remove the minus
  207.            signs (or change the 0s to space 0s) in the output file.
  208.  
  209.                                SOME EXAMPLES
  210.  
  211.            COLS 2 3 TAND (C2)AND(C3) TOR (C2)OR(C3) TNOT2 NOT(C2)
  212.            COLS 1 2 3 TSMALLNET ((C1)OR(C2))AND(C3)
  213.            COLS 2 3 TXOR (C2)XOR(C3) TEQV (C2)EQV(C3)
  214.  
  215.            The last example shows that the XOR and the EQV (or
  216.            compare) are the complements of each other.  You may
  217.            evaluate small logic networks using the FUNLOGIC.TXT
  218.            file for perfect inspection (all possible inputs) or
  219.            create your own input file for partial behavioral
  220.            exploration of larger logic networks.
  221.  
  222.  
  223.         3. The files FUN.TXT AND FUNLOGIC.TXT were included so that
  224.            users could quickly explore any expression right from the 
  225.            DOS command line using the COLS program.
  226.  
  227.            TO QUICKLY EXPLORE AN EXPRESSION FROM THE
  228.            DOS COMMAND LINE -- TYPE:
  229.  
  230.                  A. CD \COLS
  231.  
  232.                  B. COLS FUN 1 2 3 expression
  233.                                or
  234.                     COLS FUNLOGIC 1 2 3 expression
  235.  
  236.  
  237.            TO COMPARE TWO OR MORE EXPRESSIONS:
  238.            Just add the expressions to the command line
  239.            separating each with a space.
  240.  
  241.  
  242.         4. At the risk of wasting a little bandwidth, I am
  243.            also including two more fun files that might be
  244.            helpful.
  245.  
  246.            MOREFUN.TXT is similar to FUN.TXT except
  247.            that its three columns increase by powers of ten.
  248.            You may want to be careful when you use MOREFUN
  249.            since it contains a fair amount of horsepower: the
  250.            last values are 10 to the 20 power.
  251.  
  252.            LESSFUN.TXT is the same as FUN.TXT except that all
  253.            number are negative.  All the fun files stop at 20
  254.            rows because that should result in one screen full of
  255.            text without the need to scroll through the output
  256.            file.  You may want to adjust that number. 
  257.  
  258.            These fun files may be easier to create using COLS
  259.            then the new COLS user might expect.
  260.  
  261.            MOREFUN --> COLS FUN 10^C1 10^C1 10^C1 
  262.            LESSFUN --> COLS FUN -C1 -C1 -C1