From 76d70052fbe5d4e1d9e9976a3a30c7159c13b459 Mon Sep 17 00:00:00 2001
From: "Tim J. Robbins" <tjr@FreeBSD.org>
Date: Mon, 10 Jun 2002 08:50:56 +0000
Subject: [PATCH] Add an EXAMPLES section with three examples. Document the
 problem with multibyte characters and the -d option in a BUGS section.

---
 usr.bin/paste/paste.1 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/usr.bin/paste/paste.1 b/usr.bin/paste/paste.1
index 020fb04efb25..5fa2d8d3868b 100644
--- a/usr.bin/paste/paste.1
+++ b/usr.bin/paste/paste.1
@@ -110,6 +110,19 @@ is specified for one or more of the input files, the standard
 input is used; standard input is read one line at a time, circularly,
 for each instance of
 .Ql Fl .
+.Sh EXAMPLES
+List the files in the current directory in three columns:
+.Pp
+.Dl "ls | paste - - -"
+.Pp
+Combine pairs of lines from a file into single lines:
+.Pp
+.Dl "paste -s -d '\et\en' myfile"
+.Pp
+Number the lines in a file, similar to
+.Xr nl 1 :
+.Pp
+.Dl "sed = myfile | paste -s -d '\et\en' - -"
 .Sh DIAGNOSTICS
 .Ex -std
 .Sh SEE ALSO
@@ -121,3 +134,7 @@ The
 utility is expected to be
 .St -p1003.2
 compatible.
+.Sh BUGS
+Multibyte character delimiters cannot be specified with the
+.Fl d
+option.