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