[Midnightbsd-cvs] src: join.1: sync join man page

[laffer1 at midnightbsd.org]

Log Message:
-----------
sync join man page

Modified Files:
--------------
    src/usr.bin/join:
        join.1 (r1.1.1.1 -> r1.2)

-------------- next part --------------
Index: join.1
===================================================================
RCS file: /home/cvs/src/usr.bin/join/join.1,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L usr.bin/join/join.1 -L usr.bin/join/join.1 -u -r1.1.1.1 -r1.2
--- usr.bin/join/join.1
+++ usr.bin/join/join.1
@@ -33,7 +33,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)join.1	8.3 (Berkeley) 4/28/95
-.\" $FreeBSD: src/usr.bin/join/join.1,v 1.20 2005/02/13 22:25:23 ru Exp $
+.\" $FreeBSD: src/usr.bin/join/join.1,v 1.21 2006/12/21 10:59:48 ru Exp $
 .\"
 .Dd July 5, 2004
 .Dt JOIN 1
@@ -51,8 +51,8 @@
 .Bk -words
 .Ek
 .Op Fl t Ar char
-.Op Fl \&1 Ar field
-.Op Fl \&2 Ar field
+.Op Fl 1 Ar field
+.Op Fl 2 Ar field
 .Ar file1
 .Ar file2
 .Sh DESCRIPTION
@@ -100,8 +100,8 @@
 each line with matching join fields.
 Each element of
 .Ar list
-has the either the form
-.Ql file_number.field ,
+has either the form
+.Ar file_number . Ns Ar field ,
 where
 .Ar file_number
 is a file number and
@@ -129,18 +129,20 @@
 line in file
 .Ar file_number .
 The options
-.Fl v Ar 1
+.Fl v Cm 1
 and
-.Fl v Ar 2
+.Fl v Cm 2
 may be specified at the same time.
 .It Fl 1 Ar field
 Join on the
 .Ar field Ns 'th
-field of file 1.
+field of
+.Ar file1 .
 .It Fl 2 Ar field
 Join on the
 .Ar field Ns 'th
-field of file 2.
+field of
+.Ar file2 .
 .El
 .Pp
 When the default field delimiter characters are used, the files to be joined
@@ -164,7 +166,7 @@
 or
 .Ar file2
 is
-.Dq - ,
+.Sq Fl ,
 the standard input is used.
 .Sh EXIT STATUS
 .Ex -std
@@ -175,19 +177,27 @@
 .Bl -tag -width indent
 .It Fl a
 In addition to the default output, produce a line for each unpairable line
-in both file 1 and file 2.
+in both
+.Ar file1
+and
+.Ar file2 .
 .It Fl j1 Ar field
 Join on the
 .Ar field Ns 'th
-field of file 1.
+field of
+.Ar file1 .
 .It Fl j2 Ar field
 Join on the
 .Ar field Ns 'th
-field of file 2.
+field of
+.Ar file2 .
 .It Fl j Ar field
 Join on the
 .Ar field Ns 'th
-field of both file 1 and file 2.
+field of both
+.Ar file1
+and
+.Ar file2 .
 .It Fl o Ar list ...
 Historical implementations of
 .Nm
@@ -195,16 +205,16 @@
 .Fl o
 option.
 These arguments were of the form
-.Ql file_number.field_number
+.Ar file_number . Ns Ar field_number
 as described
 for the current
 .Fl o
 option.
 This has obvious difficulties in the presence of files named
-.Ql 1.2 .
+.Pa 1.2 .
 .El
 .Pp
-These options are available only so historic shellscripts do not require
+These options are available only so historic shell scripts do not require
 modification and should not be used.
 .Sh SEE ALSO
 .Xr awk 1 ,