This is a program which I wrote as a clone of the UNIX 'units'
command.  I threw it together in a couple days, but it seems to work,
with some restrictions.  I have tested it under DOS with Borland C and
Ultrix 4.2.

Adrian Mariano (adrian@u.washington.edu or mariano@geom.umn.edu)
===========================================================================

On Amiga:

Units will run from CLI/Shell and Workbench.

You may want to read `units.lib' to see what sort of units may be converted.
Over 500 different units are supported, as well as units derived from those.

Some interesting conversions:

    You have: megatons-tnt
    You want: joules
        * 4.1730498e+15
        / 2.3963289e-16
        
    You have: furlongs/fortnight
    You want: meters/second
        * 0.0001663
        / 6012.8848

I made the following changes to units:

    I added a version string that can be found by Amiga's VERSION command.
    I corrected the entry for nmile in units.lib (it was missing a space).
    I generated and #included *_protos.h files to keep SAS/C happy.
    I added the ability to type `quit' to quit the program.
    I added Workbench support.


Ron Charlton (charlton@cs.utk.edu or charltoncr@ornl.gov)
01-Aug-1994
==========================================================================

Units.doc:

NAME
   units - conversion program

SYNTAX
   units [-f filename] [-q] [to-unit from-unit]

SUMMARY

   -f filename
     Specifies the name of the units data file to load.

   -q  Supresses prompting of the user for units and the display of statis-
     tics about the number of units loaded.

   from-unit to-unit
	Allows a single unit converstion to be done directly from the com-
     	mand line.  No prompting will occur.  The units program will print
	out only the result of this single conversion.


DESCRIPTION
    The units program converts quantities expression in various scales to
    their equivalents in other scales.  The units program can only handle
    multiplicative scale changes.  It cannot convert Centigrade to
    Fahrenheit, for example.  It works interactively by prompting the user
    for input:

	You have: meters
	You want: feet
	     * 3.2808399
	     / 0.3048

	You have: cm^3
	You want: gallons
	     * 0.00026417205
	     / 3785.4118

    Powers of units can be specified using the '^' character as shown in the
    example, or by simple concatenation: 'cm3' is equivalent to 'cm^3'.
    Multiplication of units can be specified by using spaces, a dash or an
    asterisk.  Division of units is indicated by the slash ('/'). Note that
    multiplication has a higher precedence than division, so If the user
    enters incompatible unit types, the units program will print a message
    indicating that the units are not conformable and it will display the
    reduced form for each unit:

	You have: ergs/hour
	You want: fathoms kg^2 / day
	conformability error
	     2.7777778e-11 kg m^2 / sec^3
	     2.1166667e-05 kg^2 m / sec

    The conversion information is read from a units data file.  The default
    file includes definitions for most familiar units, abbreviations and
    metric prefixes.  Some constants of nature included are:

	pi       ratio of circumference to diameter
	c        speed of light
	e        charge on an electron
	g        acceleration of gravity
	force    same as g
	mole     Avogadro's number
	water    pressure per unit height of water
	mercury  pressure per unit height of mercury
	au       astronomical unit

    'Pound' is a unit of mass.  Compound names are run together so 'pound-
    force' is a unit of force.  British units that differ from their US
    counterparts are prefixed with 'br', and currency is prefixed with its
    country name: 'belgiumfranc', 'britainpound'.  When searching for a
    unit, if the specified string does not appear exactly as a unit name,
    then the units program will try to remove a trailing 's' or a trailing
    'es' and check again for a match.

    All of these definitions can be read in the standard units file, or you
    can supply your own file.  A unit is specified on a single line by giv-
    ing its name and an equivalence.  One should be careful to define new
    units in terms of old ones so that a reduction leads to the primitive
    units which are marked with '!' characters. The units program will not
    detect infinite loops that could be caused by careless unit definitions.

    Prefixes are defined in the same was as standard units, but with a
    trailing dash at the end of the prefix name.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  199     282  70.6% -lh5- ea28 Jul 28  1994 units/README
[generic]                 1068    2157  49.5% -lh5- bd5b Aug  1  1994 units/ReadMe.Amiga
[generic]                  224     384  58.3% -lh5- 336f Aug  1  1994 units/ReadMe.Amiga.info
[generic]                  225     384  58.6% -lh5- cd90 Aug  1  1994 units/README.info
[generic]                  271     628  43.2% -lh5- f349 Aug  1  1994 units/source.info
[generic]                  886    2066  42.9% -lh5- 1051 Jul 28  1994 units/source/getopt.c
[generic]                  177     336  52.7% -lh5- e4ab Jul 28  1994 units/source/getopt.h
[generic]                  103     174  59.2% -lh5- 3b4a Jul 28  1994 units/source/getopt_protos.h
[generic]                  153     190  80.5% -lh5- 3ac6 Aug  1  1994 units/source/Makefile
[generic]                   77     152  50.7% -lh5- e923 Jul 28  1994 units/source/Makefile.dos
[generic]                   77      81  95.1% -lh5- 70df Jul 28  1994 units/source/makefile.unix
[generic]                 1828    3827  47.8% -lh5- 93d4 Jul 28  1994 units/source/units.1
[generic]                 4260   14184  30.0% -lh5- 81aa Aug  1  1994 units/source/units.c
[generic]                  348    1030  33.8% -lh5- 27b0 Jul 28  1994 units/source/units_protos.h
[generic]                14027   23156  60.6% -lh5- 065e Aug  1  1994 units/units
[generic]                 1795    3889  46.2% -lh5- 85be Aug  1  1994 units/units.doc
[generic]                  227     384  59.1% -lh5- 8b19 Aug  1  1994 units/units.doc.info
[generic]                  394     835  47.2% -lh5- 916a Aug  1  1994 units/units.info
[generic]                 4757   10160  46.8% -lh5- d2bf Jul 28  1994 units/units.lib
[generic]                  209     384  54.4% -lh5- e94c Aug  1  1994 units/units.lib.info
[generic]                   76      92  82.6% -lh5- 36cd Aug  1  1994 units/units.lnk
[generic]                  268     628  42.7% -lh5- 507d Aug  1  1994 units.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        22 files   31649   65403  48.4%            Aug  4  1994