[unix-history] / usr / src / usr.bin / units / units.1

.\"	@(#)units.1	6.1 (Berkeley) %G%
.\"
.TH UNITS 1 ""
.AT 3
.if n .ds / /
.if t .ds / \z/\h'\w'*'u'
.SH NAME
units \- conversion program
.SH SYNOPSIS
.B units
.SH DESCRIPTION
.I Units
converts quantities expressed
in various standard scales to
their equivalents in other scales.
It works interactively in this fashion:
.PP
.I "	You have:"
inch
.br
.I "	You want:"
cm
.br
.I "		* 2.54000e+00
.br
.I "		\*/ 3.93701e\-01
.PP
A quantity is specified as a multiplicative combination of
units optionally preceded by a numeric multiplier.
Powers are indicated by suffixed positive integers,
division by the usual sign:
.PP
.I "	You have:"
15 pounds force/in2
.br
.I "	You want:"
atm
.br
.I "		* 1.02069e+00"
.br
.I "		\*/ 9.79730e\-01"
.PP
.I Units 
only does multiplicative scale changes.
Thus it can convert Kelvin to Rankine, but not Centigrade to
Fahrenheit.
Most familiar units,
abbreviations, and metric prefixes are recognized,
together with a generous leavening of exotica
and a few constants of nature including:
.PP
.nf
	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 head per unit height of water
	au	astronomical unit
.PP
.fi
`Pound' is a unit of
mass.
Compound names are run together, e.g. `lightyear'.
British units that differ from their US counterparts
are prefixed thus: `brgallon'.
Currency is denoted `belgiumfranc', `britainpound', ...
.PP
For a complete list of units, `cat /usr/lib/units'.
.SH FILES
/usr/lib/units
.SH BUGS
Don't base your
financial plans on the currency conversions.
Commit	Line	Data
cab7a51b	1	.\" @(#)units.1 6.1 (Berkeley) %G%
8b472826	2	.\"
cab7a51b	3	.TH UNITS 1 ""
8b472826 KM	4	.AT 3
	5	.if n .ds / /
	6	.if t .ds / \z/\h'\w'*'u'
	7	.SH NAME
	8	units \- conversion program
	9	.SH SYNOPSIS
	10	.B units
	11	.SH DESCRIPTION
	12	.I Units
	13	converts quantities expressed
	14	in various standard scales to
	15	their equivalents in other scales.
	16	It works interactively in this fashion:
	17	.PP
	18	.I " You have:"
	19	inch
	20	.br
	21	.I " You want:"
	22	cm
	23	.br
	24	.I " * 2.54000e+00
	25	.br
	26	.I " \*/ 3.93701e\-01
	27	.PP
	28	A quantity is specified as a multiplicative combination of
	29	units optionally preceded by a numeric multiplier.
	30	Powers are indicated by suffixed positive integers,
	31	division by the usual sign:
	32	.PP
	33	.I " You have:"
	34	15 pounds force/in2
	35	.br
	36	.I " You want:"
	37	atm
	38	.br
	39	.I " * 1.02069e+00"
	40	.br
	41	.I " \*/ 9.79730e\-01"
	42	.PP
	43	.I Units
	44	only does multiplicative scale changes.
	45	Thus it can convert Kelvin to Rankine, but not Centigrade to
	46	Fahrenheit.
	47	Most familiar units,
	48	abbreviations, and metric prefixes are recognized,
	49	together with a generous leavening of exotica
	50	and a few constants of nature including:
	51	.PP
	52	.nf
	53	pi ratio of circumference to diameter
	54	c speed of light
	55	e charge on an electron
	56	g acceleration of gravity
	57	force same as g
	58	mole Avogadro's number
	59	water pressure head per unit height of water
	60	au astronomical unit
	61	.PP
	62	.fi
	63	`Pound' is a unit of
	64	mass.
	65	Compound names are run together, e.g. `lightyear'.
	66	British units that differ from their US counterparts
	67	are prefixed thus: `brgallon'.
68	Currency is denoted `belgiumfranc', `britainpound', ...
69	.PP
70	For a complete list of units, `cat /usr/lib/units'.
71	.SH FILES
72	/usr/lib/units
73	.SH BUGS
74	Don't base your
75	financial plans on the currency conversions.