DESCRIPTION
-----------
This archive contains the source code and supporting documentation for trim,
an ANSI C space trimmer and tab removal program.  It replace tab characters
with enough spaces to reach the next tab stop.  Any trailing spaces will also
be removed.

Trim is released on the GNU GPL.

The latest revision of this program may be found at:
http://michael.dipperstein.com/trim.html

FILES
-----
COPYING         - Rules for copying and distributing GPL software
getopt.c        - LGPL version of getopt source from GNU project
getopt.h        - LGPL version of getopt headers from GNU project
Makefile        - makefile for this project (assumes gcc compiler and GNU make)
README          - this file
trim.c          - Main functions for this program

BUILDING
--------
To build these files with GNU make and gcc:
1. Windows users should define the environment variable OS to be Windows or
   Windows_NT.  This is often already done.
2. Enter the command "make" from the command line.

USAGE
-----
Usage: trim <options>

Options:
  -t : tab size.
  -i <filename> : Name of input file.
  -o <filename> : Name of output file.
  -h | ?  : Print out command line options.

Default: trim -t4 -i stdin -o stdout

HISTORY
-------
12/30/06  - Initial release

TODO
----
- Allow tab stop columns to be specified
- Add features found in source beautification programs
- Add a space to tab feature for crazy people that prefer tabs

AUTHOR
------
Michael Dipperstein (mdipper@alumni.engr.ucsb.edu)
