CVSROOT: /webcvs/grep Module name: grep Changes by: Jim Meyering <meyering> 16/02/05 00:44:53
Index: html_node/Matching-Control.html =================================================================== RCS file: /webcvs/grep/grep/manual/html_node/Matching-Control.html,v retrieving revision 1.21 retrieving revision 1.22 diff -u -b -r1.21 -r1.22 --- html_node/Matching-Control.html 2 Nov 2015 02:54:35 -0000 1.21 +++ html_node/Matching-Control.html 5 Feb 2016 00:44:52 -0000 1.22 @@ -1,64 +1,105 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<html> +<!-- This manual is for grep, a pattern matching engine. + +Copyright (C) 1999-2002, 2005, 2008-2016 Free Software Foundation, +Inc. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +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". --> +<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ --> <head> -<title>Matching Control - GNU Grep 2.22</title> +<title>GNU Grep 2.23: Matching Control</title> + +<meta name="description" content="GNU Grep 2.23: Matching Control"> +<meta name="keywords" content="GNU Grep 2.23: Matching Control"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<meta name="description" content="GNU Grep 2.22"> -<meta name="generator" content="makeinfo 4.13"> -<link title="Top" rel="start" href="index.html#Top"> -<link rel="up" href="Command_002dline-Options.html#Command_002dline-Options" title="Command-line Options"> -<link rel="prev" href="Generic-Program-Information.html#Generic-Program-Information" title="Generic Program Information"> -<link rel="next" href="General-Output-Control.html#General-Output-Control" title="General Output Control"> -<link href="http://www.gnu.org/software/texinfo/"; rel="generator-home" title="Texinfo Homepage"> +<link href="index.html#Top" rel="start" title="Top"> +<link href="Index.html#Index" rel="index" title="Index"> +<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> +<link href="Command_002dline-Options.html#Command_002dline-Options" rel="up" title="Command-line Options"> +<link href="General-Output-Control.html#General-Output-Control" rel="next" title="General Output Control"> +<link href="Generic-Program-Information.html#Generic-Program-Information" rel="prev" title="Generic Program Information"> +<style type="text/css"> <!-- -This manual is for `grep', a pattern matching engine. +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nocodebreak {white-space: nowrap} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: serif; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css"> -Copyright (C) 1999-2002, 2005, 2008-2015 Free Software Foundation, -Inc. - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free Documentation License, - Version 1.3 or any later version published by the Free Software - Foundation; with no 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''. - --> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family:serif; font-weight:normal; } - span.sansserif { font-family:sans-serif; font-weight:normal; } ---></style> -<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css"> </head> -<body> -<div class="node"> + +<body lang="en"> <a name="Matching-Control"></a> +<div class="header"> <p> -Next: <a rel="next" accesskey="n" href="General-Output-Control.html#General-Output-Control">General Output Control</a>, -Previous: <a rel="previous" accesskey="p" href="Generic-Program-Information.html#Generic-Program-Information">Generic Program Information</a>, -Up: <a rel="up" accesskey="u" href="Command_002dline-Options.html#Command_002dline-Options">Command-line Options</a> -<hr> +Next: <a href="General-Output-Control.html#General-Output-Control" accesskey="n" rel="next">General Output Control</a>, Previous: <a href="Generic-Program-Information.html#Generic-Program-Information" accesskey="p" rel="prev">Generic Program Information</a>, Up: <a href="Command_002dline-Options.html#Command_002dline-Options" accesskey="u" rel="up">Command-line Options</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p> </div> - +<hr> +<a name="Matching-Control-1"></a> <h4 class="subsection">2.1.2 Matching Control</h4> - <dl> -<dt><samp><span class="option">-e </span><var>pattern</var></samp><dt><samp><span class="option">--regexp=</span><var>pattern</var></samp><dd><a name="index-g_t_002de-7"></a><a name="index-g_t_002d_002dregexp_003d_0040var_007bpattern_007d-8"></a><a name="index-pattern-list-9"></a>Use <var>pattern</var> as the pattern. +<dl compact="compact"> +<dt><samp>-e <var>pattern</var></samp></dt> +<dt><samp>--regexp=<var>pattern</var></samp></dt> +<dd><a name="index-_002de"></a> +<a name="index-_002d_002dregexp_003dpattern"></a> +<a name="index-pattern-list"></a> +<p>Use <var>pattern</var> as the pattern. This can be used to specify multiple search patterns, -or to protect a pattern beginning with a ‘<samp><span class="samp">-</span></samp>’. -(<samp><span class="option">-e</span></samp> is specified by POSIX.) - - <br><dt><samp><span class="option">-f </span><var>file</var></samp><dt><samp><span class="option">--file=</span><var>file</var></samp><dd><a name="index-g_t_002df-10"></a><a name="index-g_t_002d_002dfile-11"></a><a name="index-pattern-from-file-12"></a>Obtain patterns from <var>file</var>, one per line. +or to protect a pattern beginning with a ‘<samp>-</samp>’. +(<samp>-e</samp> is specified by POSIX.) +</p> +</dd> +<dt><samp>-f <var>file</var></samp></dt> +<dt><samp>--file=<var>file</var></samp></dt> +<dd><a name="index-_002df"></a> +<a name="index-_002d_002dfile"></a> +<a name="index-pattern-from-file"></a> +<p>Obtain patterns from <var>file</var>, one per line. The empty file contains zero patterns, and therefore matches nothing. -(<samp><span class="option">-f</span></samp> is specified by POSIX.) - - <br><dt><samp><span class="option">-i</span></samp><dt><samp><span class="option">-y</span></samp><dt><samp><span class="option">--ignore-case</span></samp><dd><a name="index-g_t_002di-13"></a><a name="index-g_t_002dy-14"></a><a name="index-g_t_002d_002dignore_002dcase-15"></a><a name="index-case-insensitive-search-16"></a>Ignore case distinctions, so that characters that differ only in case +(<samp>-f</samp> is specified by POSIX.) +</p> +</dd> +<dt><samp>-i</samp></dt> +<dt><samp>-y</samp></dt> +<dt><samp>--ignore-case</samp></dt> +<dd><a name="index-_002di"></a> +<a name="index-_002dy"></a> +<a name="index-_002d_002dignore_002dcase"></a> +<a name="index-case-insensitive-search"></a> +<p>Ignore case distinctions, 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 @@ -70,14 +111,27 @@ two-character string “SS” but it does not match “SS”, and it might not match the uppercase letter “Ẕ (U+1E9E, LATIN CAPITAL LETTER SHARP S) even though lowercasing the latter yields the former. - - <p><samp><span class="option">-y</span></samp> is an obsolete synonym that is provided for compatibility. -(<samp><span class="option">-i</span></samp> is specified by POSIX.) - - <br><dt><samp><span class="option">-v</span></samp><dt><samp><span class="option">--invert-match</span></samp><dd><a name="index-g_t_002dv-17"></a><a name="index-g_t_002d_002dinvert_002dmatch-18"></a><a name="index-invert-matching-19"></a><a name="index-print-non_002dmatching-lines-20"></a>Invert the sense of matching, to select non-matching lines. -(<samp><span class="option">-v</span></samp> is specified by POSIX.) - - <br><dt><samp><span class="option">-w</span></samp><dt><samp><span class="option">--word-regexp</span></samp><dd><a name="index-g_t_002dw-21"></a><a name="index-g_t_002d_002dword_002dregexp-22"></a><a name="index-matching-whole-words-23"></a>Select only those lines containing matches that form whole words. +</p> +<p><samp>-y</samp> is an obsolete synonym that is provided for compatibility. +(<samp>-i</samp> is specified by POSIX.) +</p> +</dd> +<dt><samp>-v</samp></dt> +<dt><samp>--invert-match</samp></dt> +<dd><a name="index-_002dv"></a> +<a name="index-_002d_002dinvert_002dmatch"></a> +<a name="index-invert-matching"></a> +<a name="index-print-non_002dmatching-lines"></a> +<p>Invert the sense of matching, to select non-matching lines. +(<samp>-v</samp> is specified by POSIX.) +</p> +</dd> +<dt><samp>-w</samp></dt> +<dt><samp>--word-regexp</samp></dt> +<dd><a name="index-_002dw"></a> +<a name="index-_002d_002dword_002dregexp"></a> +<a name="index-matching-whole-words"></a> +<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. @@ -85,11 +139,29 @@ it must be either at the end of the line or followed by a non-word constituent character. Word-constituent characters are letters, digits, and the underscore. +This option has no effect if <samp>-x</samp> is also specified. +</p> +</dd> +<dt><samp>-x</samp></dt> +<dt><samp>--line-regexp</samp></dt> +<dd><a name="index-_002dx"></a> +<a name="index-_002d_002dline_002dregexp"></a> +<a name="index-match-the-whole-line"></a> +<p>Select only those matches that exactly match the whole line. +For a regular expression pattern, this is like parenthesizing the +pattern and then surrounding it with ‘<samp>^</samp>’ and ‘<samp>$</samp>’. +(<samp>-x</samp> is specified by POSIX.) +</p> +</dd> +</dl> - <br><dt><samp><span class="option">-x</span></samp><dt><samp><span class="option">--line-regexp</span></samp><dd><a name="index-g_t_002dx-24"></a><a name="index-g_t_002d_002dline_002dregexp-25"></a><a name="index-match-the-whole-line-26"></a>Select only those matches that exactly match the whole line. -(<samp><span class="option">-x</span></samp> is specified by POSIX.) +<hr> +<div class="header"> +<p> +Next: <a href="General-Output-Control.html#General-Output-Control" accesskey="n" rel="next">General Output Control</a>, Previous: <a href="Generic-Program-Information.html#Generic-Program-Information" accesskey="p" rel="prev">Generic Program Information</a>, Up: <a href="Command_002dline-Options.html#Command_002dline-Options" accesskey="u" rel="up">Command-line Options</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p> +</div> -</dl> - </body></html> +</body> +</html>
