explain units' output a little more clearly;

1 files changed, 15 insertions, 9 deletions

diff --git a/usr.bin/units/units.1 b/usr.bin/units/units.1
index 65a8cc262a0..db43aedfa86 100644
--- a/usr.bin/units/units.1
+++ b/usr.bin/units/units.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: units.1,v 1.23 2011/10/06 19:58:47 jmc Exp $
+.\" $OpenBSD: units.1,v 1.24 2011/10/08 20:41:12 jmc Exp $
 .\" converted to new format by deraadt@openbsd.org
 .\"
 .\" Copyright (c) 1993 by Adrian Mariano (adrian@cam.cornell.edu)
@@ -16,7 +16,7 @@
 .\" I would appreciate (though I do not require) receiving a copy of any
 .\" improvements you might make to this program.
 .\"
-.Dd $Mdocdate: October 6 2011 $
+.Dd $Mdocdate: October 8 2011 $
 .Dt UNITS 1
 .Os
 .Sh NAME
@@ -38,7 +38,9 @@ program can only handle multiplicative scale changes.
 It cannot convert Celsius
 to Fahrenheit, for example.
 It also does not handle logarithmic units such as bels.
-It works interactively by prompting the user for input:
+.Pp
+.Nm
+works interactively by prompting the user for input:
 .Bd -literal -offset indent
 You have: meters
 You want: feet
@@ -51,6 +53,10 @@ You want: gallons
         / 3785.4118
 .Ed
 .Pp
+That is, one meter equals roughly 3.28 feet
+(or, conversely, one foot is roughly equal to 0.3 meters),
+and one gallon is roughly equal to 3785 cubic cm.
+.Pp
 The
 .Nm
 program can handle numbers as well:
@@ -60,14 +66,14 @@ You want: km/hr
         * 96.56064
         / 0.010356187
 
-You have: 5 austriaschilling
-You want: 100 italylira
-        * 7.0357114
-        / 0.14213204
+You have: 100 USD
+You want: 10 euro
+        * 7.4354971
+        / 0.13449
 .Ed
 .Pp
-In other words, 60 miles per hour is about 96.6 km/hr, and 5 Austrian
-Schillings will get you seven 100-Lira coins.
+In other words, 60 miles per hour is about 96.6 km/hr,
+and 100 US dollars will get you seven 10-Euro notes.
 .Pp
 The options are as follows:
 .Bl -tag -width Ds