diff options
Diffstat (limited to 'man/join.1')
-rw-r--r-- | man/join.1 | 79 |
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. |