CVSROOT: /webcvs/grep Module name: grep Changes by: Jim Meyering <meyering> 25/04/11 13:06:09
Index: html_node/Matching-Control.html =================================================================== RCS file: /webcvs/grep/grep/manual/html_node/Matching-Control.html,v retrieving revision 1.35 retrieving revision 1.36 diff -u -b -r1.35 -r1.36 --- html_node/Matching-Control.html 13 May 2023 09:23:53 -0000 1.35 +++ html_node/Matching-Control.html 11 Apr 2025 17:06:07 -0000 1.36 @@ -1,11 +1,11 @@ <!DOCTYPE html> <html> -<!-- Created by GNU Texinfo 7.0dev, https://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 7.1.1, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual is for grep, a pattern matching engine. -Copyright © 1999-2002, 2005, 2008-2023 Free Software Foundation, +Copyright © 1999-2002, 2005, 2008-2025 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document @@ -14,10 +14,10 @@ Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". --> -<title>Matching Control (GNU Grep 3.11)</title> +<title>Matching Control (GNU Grep 3.12)</title> -<meta name="description" content="Matching Control (GNU Grep 3.11)"> -<meta name="keywords" content="Matching Control (GNU Grep 3.11)"> +<meta name="description" content="Matching Control (GNU Grep 3.12)"> +<meta name="keywords" content="Matching Control (GNU Grep 3.12)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> @@ -50,12 +50,11 @@ <h4 class="subsection" id="Matching-Control-1"><span>2.1.2 Matching Control<a class="copiable-link" href="#Matching-Control-1"> ¶</a></span></h4> <dl class="table"> -<dt><samp class="option">-e <var class="var">patterns</var></samp></dt> -<dt><samp class="option">--regexp=<var class="var">patterns</var></samp></dt> -<dd><a class="index-entry-id" id="index-_002de"></a> -<a class="index-entry-id" id="index-_002d_002dregexp_003dpatterns"></a> +<dt><a class="index-entry-id" id="index-_002d_002dregexp_003dpatterns"></a> <a class="index-entry-id" id="index-patterns-option"></a> -<p>Use <var class="var">patterns</var> as one or more patterns; newlines within +<a id="index-_002de"></a><span><samp class="option">-e <var class="var">patterns</var></samp><a class="copiable-link" href="#index-_002de"> ¶</a></span></dt> +<dt><samp class="option">--regexp=<var class="var">patterns</var></samp></dt> +<dd><p>Use <var class="var">patterns</var> as one or more patterns; newlines within <var class="var">patterns</var> separate each pattern from the next. If this option is used multiple times or is combined with the <samp class="option">-f</samp> (<samp class="option">--file</samp>) option, search for all patterns given. @@ -64,12 +63,11 @@ (<samp class="option">-e</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">-f <var class="var">file</var></samp></dt> -<dt><samp class="option">--file=<var class="var">file</var></samp></dt> -<dd><a class="index-entry-id" id="index-_002df"></a> -<a class="index-entry-id" id="index-_002d_002dfile"></a> +<dt><a class="index-entry-id" id="index-_002d_002dfile"></a> <a class="index-entry-id" id="index-patterns-from-file"></a> -<p>Obtain patterns from <var class="var">file</var>, one per line. +<a id="index-_002df"></a><span><samp class="option">-f <var class="var">file</var></samp><a class="copiable-link" href="#index-_002df"> ¶</a></span></dt> +<dt><samp class="option">--file=<var class="var">file</var></samp></dt> +<dd><p>Obtain patterns from <var class="var">file</var>, one per line. If this option is used multiple times or is combined with the <samp class="option">-e</samp> (<samp class="option">--regexp</samp>) option, search for all patterns given. When <var class="var">file</var> is ‘<samp class="samp">-</samp>’, read patterns from standard input. @@ -77,57 +75,55 @@ (<samp class="option">-f</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">-i</samp></dt> -<dt><samp class="option">-y</samp></dt> -<dt><samp class="option">--ignore-case</samp></dt> -<dd><a class="index-entry-id" id="index-_002di"></a> -<a class="index-entry-id" id="index-_002dy"></a> +<dt><a class="index-entry-id" id="index-_002dy"></a> <a class="index-entry-id" id="index-_002d_002dignore_002dcase"></a> <a class="index-entry-id" id="index-case-insensitive-search"></a> -<p>Ignore case distinctions in patterns and input data, +<a id="index-_002di"></a><span><samp class="option">-i</samp><a class="copiable-link" href="#index-_002di"> ¶</a></span></dt> +<dt><samp class="option">-y</samp></dt> +<dt><samp class="option">--ignore-case</samp></dt> +<dd><p>Ignore case distinctions in patterns and input data, so that characters that differ only in case match each other. Although this is straightforward when letters differ in case only via lowercase-uppercase pairs, the behavior is unspecified in other situations. For example, uppercase “S” has an -unusual lowercase counterpart “Å¿” (Unicode character U+017F, LATIN +unusual lowercase counterpart +“Å¿” +(Unicode character U+017F LATIN SMALL LETTER LONG S) in many locales, and it is unspecified whether this unusual character matches “S” or “s” even though uppercasing it yields “S”. Another example: the lowercase German letter “Ô -(U+00DF, LATIN SMALL LETTER SHARP S) is normally capitalized as the +(U+00DF LATIN SMALL LETTER SHARP S) is normally capitalized as the two-character string “SS” but it does not match “SS”, and it might not match the uppercase letter “Ẕ -(U+1E9E, LATIN CAPITAL LETTER +(U+1E9E LATIN CAPITAL LETTER SHARP S) even though lowercasing the latter yields the former. </p> <p><samp class="option">-y</samp> is an obsolete synonym that is provided for compatibility. (<samp class="option">-i</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">--no-ignore-case</samp></dt> -<dd><a class="index-entry-id" id="index-_002d_002dno_002dignore_002dcase"></a> -<p>Do not ignore case distinctions in patterns and input data. This is +<dt><a id="index-_002d_002dno_002dignore_002dcase"></a><span><samp class="option">--no-ignore-case</samp><a class="copiable-link" href="#index-_002d_002dno_002dignore_002dcase"> ¶</a></span></dt> +<dd><p>Do not ignore case distinctions in patterns and input data. This is the default. This option is useful for passing to shell scripts that already use <samp class="option">-i</samp>, in order to cancel its effects because the two options override each other. </p> </dd> -<dt><samp class="option">-v</samp></dt> -<dt><samp class="option">--invert-match</samp></dt> -<dd><a class="index-entry-id" id="index-_002dv"></a> -<a class="index-entry-id" id="index-_002d_002dinvert_002dmatch"></a> +<dt><a class="index-entry-id" id="index-_002d_002dinvert_002dmatch"></a> <a class="index-entry-id" id="index-invert-matching"></a> <a class="index-entry-id" id="index-print-non_002dmatching-lines"></a> -<p>Invert the sense of matching, to select non-matching lines. +<a id="index-_002dv"></a><span><samp class="option">-v</samp><a class="copiable-link" href="#index-_002dv"> ¶</a></span></dt> +<dt><samp class="option">--invert-match</samp></dt> +<dd><p>Invert the sense of matching, to select non-matching lines. (<samp class="option">-v</samp> is specified by POSIX.) </p> </dd> -<dt><samp class="option">-w</samp></dt> -<dt><samp class="option">--word-regexp</samp></dt> -<dd><a class="index-entry-id" id="index-_002dw"></a> -<a class="index-entry-id" id="index-_002d_002dword_002dregexp"></a> +<dt><a class="index-entry-id" id="index-_002d_002dword_002dregexp"></a> <a class="index-entry-id" id="index-matching-whole-words"></a> -<p>Select only those lines containing matches that form whole words. +<a id="index-_002dw"></a><span><samp class="option">-w</samp><a class="copiable-link" href="#index-_002dw"> ¶</a></span></dt> +<dt><samp class="option">--word-regexp</samp></dt> +<dd><p>Select only those lines containing matches that form whole words. The test is that the matching substring must either be at the beginning of the line, or preceded by a non-word constituent character. @@ -145,12 +141,11 @@ word constituent. See <a class="xref" href="Special-Backslash-Expressions.html">Special Backslash Expressions</a>. </p> </dd> -<dt><samp class="option">-x</samp></dt> -<dt><samp class="option">--line-regexp</samp></dt> -<dd><a class="index-entry-id" id="index-_002dx"></a> -<a class="index-entry-id" id="index-_002d_002dline_002dregexp"></a> +<dt><a class="index-entry-id" id="index-_002d_002dline_002dregexp"></a> <a class="index-entry-id" id="index-match-the-whole-line"></a> -<p>Select only those matches that exactly match the whole line. +<a id="index-_002dx"></a><span><samp class="option">-x</samp><a class="copiable-link" href="#index-_002dx"> ¶</a></span></dt> +<dt><samp class="option">--line-regexp</samp></dt> +<dd><p>Select only those matches that exactly match the whole line. For regular expression patterns, this is like parenthesizing each pattern and then surrounding it with ‘<samp class="samp">^</samp>’ and ‘<samp class="samp">$</samp>’. (<samp class="option">-x</samp> is specified by POSIX.)
