From: Jim Meyering <jim@meyering.net>
Date: Sun, 18 Feb 1996 17:58:01 +0000 (+0000)
Subject: (join): Describe new --ignore-case (-i) option.
X-Git-Tag: FILEUTILS-3_12j~79
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=777d5f0ba865ccc44651faf151d7311de0ddc4b6;p=thirdparty%2Fcoreutils.git

(join): Describe new --ignore-case (-i) option.
---

diff --git a/doc/textutils.texi b/doc/textutils.texi
index ecc09b8748..8cc827f623 100644
--- a/doc/textutils.texi
+++ b/doc/textutils.texi
@@ -2204,7 +2204,9 @@ Either @var{file1} or @var{file2} (but not both) can be @samp{-},
 meaning standard input.  @var{file1} and @var{file2} should be already
 sorted in increasing order (not numerically) on the join fields; unless
 the @samp{-t} option is given, they should be sorted ignoring blanks at
-the start of the line, as in @code{sort -b}.
+the start of the join field, as in @code{sort -b}.  If the
+@samp{--ignore-case} option is given, lines should be sorted without
+regard to the case of characters in the join field, as in @code{sort -f}.
 
 The defaults are: the join field is the first field in each line;
 fields in the input are separated by one or more blanks, with leading
@@ -2226,6 +2228,14 @@ Print a line for each unpairable line in file @var{file-number} (either
 Replace those output fields that are missing in the input with
 @var{string}.
 
+@item -i
+@itemx --ignore-case
+@opindex -i
+@opindex --ignore-case
+Ignore differences in case when comparing keys.
+With this option, the lines of the input files must be ordered in the same way.
+Use @samp{sort -f} to produce this ordering.
+
 @item -1 @var{field}
 @itemx -j1 @var{field}
 @opindex -1