Add an EXAMPLES section with three examples. Document the problem with

multibyte characters and the -d option in a BUGS section.

1 files changed, 17 insertions, 0 deletions

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.