EXAMPLES:

- actually say what the example does
- use a display instead of .Dl, so we don;t have to escape everything
- use a prompt and indicate line break
- use "echo" instead of "printf", so we don;t need to specify newline

additionally, use .Ex whilst in here;

ok otto

1 files changed, 9 insertions, 6 deletions

diff --git a/usr.bin/column/column.1 b/usr.bin/column/column.1
index 7ce07dd0ea6..a4202443177 100644
--- a/usr.bin/column/column.1
+++ b/usr.bin/column/column.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: column.1,v 1.11 2007/05/31 19:20:08 jmc Exp $
+.\"	$OpenBSD: column.1,v 1.12 2008/03/11 16:50:05 jmc Exp $
 .\"	$NetBSD: column.1,v 1.3 1995/03/26 09:08:28 glass Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)column.1	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: March 11 2008 $
 .Dt COLUMN 1
 .Os
 .Sh NAME
@@ -73,9 +73,7 @@ Useful for pretty-printing displays.
 Fill columns before filling rows.
 .El
 .Pp
-The
-.Nm
-utility exits 0 on success or >0 if an error occurred.
+.Ex -std column
 .Sh ENVIRONMENT
 .Bl -tag -width COLUMNS
 .It Ev COLUMNS
@@ -85,7 +83,12 @@ is used to determine the size of
 the screen if no other information is available.
 .El
 .Sh EXAMPLES
-.Dl (printf \&"PERM\ LINKS\ OWNER\ GROUP\ SIZE\ MONTH\ DAY\ HH:MM/YEAR\ NAME\en\&"\ \&; ls -l\ \&| sed 1d) \&| column -t
+List the current working directory's contents, in detail,
+with nicely formatted headings for each of the fields:
+.Bd -literal -offset 4n
+$ (echo "PERM LINKS OWNER GROUP SIZE MONTH DAY HH:MM/YEAR NAME" ; \e
+	ls -l | sed 1d) | column -t
+.Ed
 .Sh SEE ALSO
 .Xr colrm 1 ,
 .Xr ls 1 ,