1 058b0118 2005-01-03 devnull .TH UNITS 1
  2 058b0118 2005-01-03 devnull .if n .ds / /
  3 058b0118 2005-01-03 devnull .SH NAME
  4 058b0118 2005-01-03 devnull units \- conversion program
  5 058b0118 2005-01-03 devnull .SH SYNOPSIS
  6 058b0118 2005-01-03 devnull .B units
  7 058b0118 2005-01-03 devnull [
  8 058b0118 2005-01-03 devnull .B -v
  9 058b0118 2005-01-03 devnull ]
 10 058b0118 2005-01-03 devnull [
 11 058b0118 2005-01-03 devnull .I file
 12 058b0118 2005-01-03 devnull ]
 13 058b0118 2005-01-03 devnull .SH DESCRIPTION
 14 058b0118 2005-01-03 devnull .I Units
 15 058b0118 2005-01-03 devnull converts quantities expressed
 16 058b0118 2005-01-03 devnull in various standard scales to
 17 058b0118 2005-01-03 devnull their equivalents in other scales.
 18 058b0118 2005-01-03 devnull It works interactively in this fashion:
 19 058b0118 2005-01-03 devnull .IP
 20 058b0118 2005-01-03 devnull .EX
 21 058b0118 2005-01-03 devnull you have: inch
 22 058b0118 2005-01-03 devnull you want: cm
 23 058b0118 2005-01-03 devnull     * 2.54
 24 058b0118 2005-01-03 devnull     / 0.393701
 25 058b0118 2005-01-03 devnull .EE
 26 058b0118 2005-01-03 devnull .PP
 27 058b0118 2005-01-03 devnull A quantity is specified as a multiplicative combination
 28 058b0118 2005-01-03 devnull of units and floating point numbers.
 29 058b0118 2005-01-03 devnull Operators have the following precedence:
 30 058b0118 2005-01-03 devnull .IP
 31 058b0118 2005-01-03 devnull .EX
 32 058b0118 2005-01-03 devnull .ta \w'\fLXXXXXXXXXXXXXXX'u
 33 058b0118 2005-01-03 devnull \fL+\fP \fL-\fP	\f1add and subtract
 34 058b0118 2005-01-03 devnull \fL*\fP \fL/\fP \fL×\fP \fL÷\fP	\f1multiply and divide
 35 058b0118 2005-01-03 devnull catenation	multiply
 36 058b0118 2005-01-03 devnull \fL²\fP \fL³\fP \fL^\fP	\f1exponentiation
 37 058b0118 2005-01-03 devnull \fL|\fP	\f1divide
 38 058b0118 2005-01-03 devnull \fL(\fP ... \fL)\fP	\f1grouping
 39 058b0118 2005-01-03 devnull .EE
 40 058b0118 2005-01-03 devnull .PP
 41 058b0118 2005-01-03 devnull Most familiar units,
 42 058b0118 2005-01-03 devnull abbreviations, and metric prefixes are recognized,
 43 058b0118 2005-01-03 devnull together with a generous leavening of exotica
 44 058b0118 2005-01-03 devnull and a few constants of nature including:
 45 058b0118 2005-01-03 devnull .IP
 46 058b0118 2005-01-03 devnull .de fq
 47 058b0118 2005-01-03 devnull \fL\\$1\\fP	\\$2 \\$3 \\$4 \\$5 \\$6
 48 058b0118 2005-01-03 devnull ..
 49 058b0118 2005-01-03 devnull .ta \w'\fLwaterXXX'u
 50 058b0118 2005-01-03 devnull .nf
 51 058b0118 2005-01-03 devnull .fq pi,\f1π\fP ratio of circumference to diameter
 52 058b0118 2005-01-03 devnull .fq c speed of light
 53 058b0118 2005-01-03 devnull .fq e charge on an electron
 54 058b0118 2005-01-03 devnull .fq g acceleration of gravity
 55 058b0118 2005-01-03 devnull .fq force same as \fLg\fP
 56 058b0118 2005-01-03 devnull .fq mole Avogadro's number
 57 058b0118 2005-01-03 devnull .fq water "pressure head per unit height of water"
 58 058b0118 2005-01-03 devnull .fq au astronomical unit
 59 058b0118 2005-01-03 devnull .fi
 60 058b0118 2005-01-03 devnull .PP
 61 058b0118 2005-01-03 devnull The
 62 058b0118 2005-01-03 devnull .L pound
 63 058b0118 2005-01-03 devnull is a unit of
 64 058b0118 2005-01-03 devnull mass.
 65 058b0118 2005-01-03 devnull Compound names are run together, e.g.
 66 058b0118 2005-01-03 devnull .LR lightyear .
 67 058b0118 2005-01-03 devnull British units that differ from their US counterparts
 68 058b0118 2005-01-03 devnull are prefixed thus:
 69 058b0118 2005-01-03 devnull .LR brgallon .
 70 058b0118 2005-01-03 devnull Currency is denoted
 71 058b0118 2005-01-03 devnull .LR belgiumfranc ,
 72 058b0118 2005-01-03 devnull .LR britainpound ,
 73 058b0118 2005-01-03 devnull etc.
 74 058b0118 2005-01-03 devnull .PP
 75 058b0118 2005-01-03 devnull The complete list of units can be found in
 76 c8b6342d 2005-01-13 devnull .BR \*9/lib/units .
 77 058b0118 2005-01-03 devnull A
 78 058b0118 2005-01-03 devnull .I file
 79 058b0118 2005-01-03 devnull argument to
 80 058b0118 2005-01-03 devnull .I units
 81 058b0118 2005-01-03 devnull specifies a file to be used instead of
 82 c8b6342d 2005-01-13 devnull .BR \*9/lib/units.
 83 058b0118 2005-01-03 devnull The
 84 058b0118 2005-01-03 devnull .B -v
 85 058b0118 2005-01-03 devnull flag causes
 86 058b0118 2005-01-03 devnull .I units
 87 058b0118 2005-01-03 devnull to print its entire database.
 88 058b0118 2005-01-03 devnull .SH EXAMPLE
 89 058b0118 2005-01-03 devnull .EX
 90 058b0118 2005-01-03 devnull you have: 15 pounds force/in²
 91 058b0118 2005-01-03 devnull you want: atm
 92 058b0118 2005-01-03 devnull     * 1.02069
 93 058b0118 2005-01-03 devnull     / .97973
 94 058b0118 2005-01-03 devnull .EE
 95 058b0118 2005-01-03 devnull .SH FILES
 96 c8b6342d 2005-01-13 devnull .B \*9/lib/units
 97 058b0118 2005-01-03 devnull .SH SOURCE
 98 c3674de4 2005-01-11 devnull .B \*9/src/cmd/units.y
 99 058b0118 2005-01-03 devnull .SH BUGS
100 058b0118 2005-01-03 devnull Since
101 058b0118 2005-01-03 devnull .I units
102 058b0118 2005-01-03 devnull does only multiplicative scale changes,
103 058b0118 2005-01-03 devnull it can convert Kelvin to Rankine but not Centigrade to
104 058b0118 2005-01-03 devnull Fahrenheit.
105 c8b6342d 2005-01-13 devnull .PP
106 058b0118 2005-01-03 devnull Currency conversions are only as accurate as the last time someone
107 c8b6342d 2005-01-13 devnull updated the database.