This file documents TextTools Release 1, of 25-Feb-96.

TERMS

    All TextTools programs and documentation are
    Copyright (c) 1996 by Rune Berg. All right reserved.

    TextTools Release 1 is Freeware. It may be freely distributed
    and used for non-commercial purposes only. It may be included on
    Shareware/Freeware/PD CD-ROM collections, though. 
    It must not be modified in any way, and must be distributed in
    its entirety.

    Please note that future TextTools releases may well be Shareware.

    Rune Berg disclaims all warranties as to this software and
    its documentation, whether express or implied, including without 
    limitation any implied warranties of merchantability, fitness for 
    a particular purpose, functionality or data integrity or protection.

INTRODUCTION

    TextTools is a collection of ASCII text filters and other goodies.
    Many of the programs process text-format tables, and offer powerful
    and unique functionality.

    All TextTools programs are run from the command line, or from
    batch files.

    Table-oriented programs:

        tcols     - project and transform table columns
        trows     - print table rows that fulfill given conditions
        tsort     - sort table on result of projection/transform
        tand      - print table entries present in two files
        tjoin     - database-style join of two tables

    Programs for printing part of files:

        first     - print first few lines of file
        last      - print last few lines of file
        lines     - print specifically numbered lines of file
        middle    - print middle part of file

    Other text filters:

        eol       - convert between DOS and UNIX end-of-line styles
        xtabs     - expand tabs to spaces
        itabs     - insert tabs in place of spaces

    Miscallenous:

        lsx       - list directory contents grouped on base file name
        sum       - sum upp integers in file
        acho      - echo with ANSI codes for colour etc.
        closure   - compute closure of graph of text nodes
        create    - create empty files
        dump      - dump file contents in hex/decimal/octal

FILE CONTENTS

    doc/ contains documentation for the TextTools programs.
   
    exe.dos/ contains the DOS executables.

PROGRAM VERSIONS
                           Status wrt.
    Name          Version  prev. rel.
    ----------------------------------------------
    acho          1.01     NEW
    closure       1.01     NEW
    create        1.01     NEW
    dump          1.00     NEW
    eol           1.02     NEW
    first         1.01     NEW
    itabs         1.01     NEW
    last          1.01     NEW
    lines         1.00     NEW
    lsx           1.02     NEW
    middle        1.02     NEW
    sum           1.02     NEW
    tand          1.02     NEW
    tcols         1.10     NEW
    tjoin         1.02     NEW
    trows         1.10     NEW
    tsort         1.10     NEW
    xtabs         1.01     NEW
    
IMPORTANT NOTES

    This is the first release. Though well tested, expect some bugs.

    All included executables run in real-mode, and don't use expanded
    or extended memory. Thus, some of the programs have limited capacity.

    All included executables are debug builds, i.e. they're compiled
    with asserts etc., to help in catching bugs in this initial release.
    This means they run a little slower than they really could.


Ok, hope you find these programs useful. Any feedback is much appreciated.

E-mail to: 

    runeberg@telepost.no

Snail-mail to:

    Rune Berg
    Steinspranget 44
    1156 Oslo
    Norway


Cheers,
- Rune