* src/grep.c: The new -T/--initial-tab framework, only

  partially used at this point to make for a simpler initial
  patch in CVS.  A subset of patch #3644 on Savannah.
  The option name/calling convention is the same as for GNU diff.
* doc/grep.texi, doc/grep.1: Document -T/--initial-tab.

1 files changed, 16 insertions, 0 deletions

diff --git a/doc/grep.texi b/doc/grep.texi
index e0de9815..e42324fa 100644
--- a/doc/grep.texi
+++ b/doc/grep.texi
@@ -523,6 +523,22 @@ yields better performance.  However, @samp{--mmap} can cause undefined
 behavior (including core dumps) if an input file shrinks while
 @command{grep} is operating, or if an I/O error occurs.
 
+@item -T
+@itemx --initial-tab
+@opindex -T
+@opindex --initial-tab
+@cindex tab-aligned content lines
+Makes sure that the first character of actual line content lies on a
+tab stop, so that the alignment of tabs looks normal.
+This is useful when combined with @samp{-H} (which is implicit when
+there is more than one file to search), @samp{-n}, and @samp{-b};
+these options prepend their output at the beginning of the displayed
+line, before the actual content.
+In order to improve the probability that all matched or context lines
+from a single file will all start at the same column, this also causes
+the line number and octet offset (if present) to be printed in a minimum
+size field width.
+
 @item -Z
 @itemx --null
 @opindex -Z