summaryrefslogtreecommitdiff
path: root/man/join.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/join.1')
-rw-r--r--man/join.179
1 files changed, 79 insertions, 0 deletions
diff --git a/man/join.1 b/man/join.1
new file mode 100644
index 0000000..4aeedff
--- /dev/null
+++ b/man/join.1
@@ -0,0 +1,79 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
+.TH JOIN "1" "March 2007" "GNU coreutils 6.9" "User Commands"
+.SH NAME
+join \- join lines of two files on a common field
+.SH SYNOPSIS
+.B join
+[\fIOPTION\fR]... \fIFILE1 FILE2\fR
+.SH DESCRIPTION
+.\" Add any additional description here
+.PP
+For each pair of input lines with identical join fields, write a line to
+standard output. The default join field is the first, delimited
+by whitespace. When FILE1 or FILE2 (not both) is \-, read standard input.
+.TP
+\fB\-a\fR FILENUM
+print unpairable lines coming from file FILENUM, where
+FILENUM is 1 or 2, corresponding to FILE1 or FILE2
+.TP
+\fB\-e\fR EMPTY
+replace missing input fields with EMPTY
+.TP
+\fB\-i\fR, \fB\-\-ignore\-case\fR
+ignore differences in case when comparing fields
+.TP
+\fB\-j\fR FIELD
+equivalent to `\-1 FIELD \fB\-2\fR FIELD'
+.TP
+\fB\-o\fR FORMAT
+obey FORMAT while constructing output line
+.TP
+\fB\-t\fR CHAR
+use CHAR as input and output field separator
+.TP
+\fB\-v\fR FILENUM
+like \fB\-a\fR FILENUM, but suppress joined output lines
+.TP
+\fB\-1\fR FIELD
+join on this FIELD of file 1
+.TP
+\fB\-2\fR FIELD
+join on this FIELD of file 2
+.TP
+\fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-\-version\fR
+output version information and exit
+.PP
+Unless \fB\-t\fR CHAR is given, leading blanks separate fields and are ignored,
+else fields are separated by CHAR. Any FIELD is a field number counted
+from 1. FORMAT is one or more comma or blank separated specifications,
+each being `FILENUM.FIELD' or `0'. Default FORMAT outputs the join field,
+the remaining fields from FILE1, the remaining fields from FILE2, all
+separated by CHAR.
+.PP
+Important: FILE1 and FILE2 must be sorted on the join fields.
+E.g., use `sort \fB\-k\fR 1b,1' if `join' has no options.
+.SH AUTHOR
+Written by Mike Haertel.
+.SH "REPORTING BUGS"
+Report bugs to <bug\-coreutils@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2007 Free Software Foundation, Inc.
+.br
+This is free software. You may redistribute copies of it under the terms of
+the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+The full documentation for
+.B join
+is maintained as a Texinfo manual. If the
+.B info
+and
+.B join
+programs are properly installed at your site, the command
+.IP
+.B info join
+.PP
+should give you access to the complete manual.