Page MenuHomeFreeBSD
Files F142645198

D24096.diff
No OneTemporary
Actions

D24096.diff
View Options

Index: head/usr.bin/units/units.1
===================================================================
--- head/usr.bin/units/units.1
+++ head/usr.bin/units/units.1
@@ -1,5 +1,5 @@
.\" $FreeBSD$
-.Dd February 3, 2020
+.Dd March 17, 2020
.Dt UNITS 1
.Os
.Sh NAME
@@ -232,8 +232,21 @@
.Ex -std
.Sh EXAMPLES
.Bl -tag -width 0n
-.It Sy Example 1 : No Interactive usage
+.It Sy Example 1 : No Simple conversion of units
.Pp
+This example shows how to do simple conversions, for example from gigabytes
+to bytes:
+.Bd -literal -offset 2n
+.Li $ Ic units -o %0.f -t '4 gigabytes' bytes
+4294967296
+.Ed
+.Pp
+The
+.Fl o Cm %0.f
+part of the command is required to print the result in a non-scientific
+notation (e.g, 4294967296 instead of 4.29497e+09).
+.It Sy Example 2 : No Interactive usage
+.Pp
Here is an example of an interactive session where the user is prompted for
units:
.Bd -literal -offset 2n
@@ -261,7 +274,7 @@
.Li You want : Ic degC
29.444444
.Ed
-.It Sy Example 2 : No Difference between Do Ic \&| Dc No and Do Ic / Dc No division
+.It Sy Example 3 : No Difference between Do Ic \&| Dc No and Do Ic / Dc No division
.Pp
The following command shows how to convert half a meter to centimeters.
.Bd -literal -offset 2n
@@ -293,7 +306,7 @@
.Dq Ic 0.5/meter ,
which is not conformable to
.Dq Ic cm .
-.It Sy Example 3 : No Simple units file
+.It Sy Example 4 : No Simple units file
Here is an example of a short units file that defines some basic
units:
.Pp
@@ -307,7 +320,7 @@
.It "ft 12 inches"
.It "mile 5280 ft"
.El
-.It Sy Example 4 : No Viewing units and conversions of the default units file
+.It Sy Example 5 : No Viewing units and conversions of the default units file
The following shell one-liner allows the user to view the contents of the
default units file:
.Bd -literal -offset 2n

File Metadata

Mime Type
text/plain
Expires
Thu, Jan 22, 7:53 PM (5 h, 3 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
27860976
Default Alt Text
D24096.diff (1 KB)

Event Timeline