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
COPYING.LESSER  - Rules for copying and distributing LGPL software
Makefile        - makefile for this project (assumes gcc compiler and GNU make)
optlist.c       - Source code for GetOptlist function and supporting functions
optlist.h       - Header file to be included by code using the optlist library
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
08/31/07  - Explicitly licensed under LGPL version 3.
          - Replaces getopt() with optlist library.

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)
