[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Changes to grep/manual/grep.html,v
|
From: |
Jim Meyering |
|
Subject: |
Changes to grep/manual/grep.html,v |
|
Date: |
Fri, 23 May 2014 05:40:06 +0000 |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 14/05/23 05:40:03
Index: grep.html
===================================================================
RCS file: /webcvs/grep/grep/manual/grep.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- grep.html 21 Feb 2014 17:16:45 -0000 1.17
+++ grep.html 23 May 2014 05:39:56 -0000 1.18
@@ -1,8 +1,8 @@
<html lang="en">
<head>
-<title>GNU Grep 2.18</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="GNU Grep 2.18">
+<title>GNU Grep 2.19</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="GNU Grep 2.19">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/"; rel="generator-home"
title="Texinfo Homepage">
@@ -33,7 +33,7 @@
--></style>
</head>
<body>
-<h1 class="settitle">GNU Grep 2.18</h1>
+<h1 class="settitle">GNU Grep 2.19</h1>
<div class="contents">
<h2>Table of Contents</h2>
<ul>
@@ -91,11 +91,11 @@
<p><samp><span class="command">grep</span></samp> prints lines that contain a
match for a pattern.
- <p>This manual is for version 2.18 of GNU Grep.
+ <p>This manual is for version 2.19 of GNU Grep.
<p>This manual is for <samp><span class="command">grep</span></samp>, a
pattern matching engine.
- <p>Copyright © 1999-2002, 2005, 2008-2014 Free Software Foundation,
+ <p>Copyright © 1999–2002, 2005, 2008–2014 Free Software
Foundation,
Inc.
<blockquote>
@@ -249,8 +249,20 @@
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 in both
the pattern and the input files.
-<samp><span class="option">-y</span></samp> is an obsolete synonym that is
provided for compatibility.
+ <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
+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
+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
+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.
@@ -469,11 +481,10 @@
<br><dt><samp><span class="option">-C
</span><var>num</var></samp><dt><samp><span
class="option">-</span><var>num</var></samp><dt><samp><span
class="option">--context=</span><var>num</var></samp><dd><a
name="index-g_t_002dC-84"></a><a name="index-g_t_002d_002dcontext-85"></a><a
name="index-g_t_002d_0040var_007bnum_007d-86"></a><a
name="index-context-87"></a>Print <var>num</var> lines of leading and trailing
output context.
<br><dt><samp><span
class="option">--group-separator=</span><var>string</var></samp><dd><a
name="index-g_t_002d_002dgroup_002dseparator-88"></a><a
name="index-group-separator-89"></a>When <samp><span
class="option">-A</span></samp>, <samp><span class="option">-B</span></samp> or
<samp><span class="option">-C</span></samp> are in use,
-print <var>string</var> instead of <samp><span class="option">--</span></samp>
around disjoint groups
-of lines.
+print <var>string</var> instead of <samp><span class="option">--</span></samp>
between groups of lines.
<br><dt><samp><span
class="option">--no-group-separator</span></samp><dd><a
name="index-g_t_002d_002dgroup_002dseparator-90"></a><a
name="index-group-separator-91"></a>When <samp><span
class="option">-A</span></samp>, <samp><span class="option">-B</span></samp> or
<samp><span class="option">-C</span></samp> are in use,
-print disjoint groups of lines adjacent to each other.
+do not print a separator between groups of lines.
</dl>
@@ -486,23 +497,22 @@
<li>Context (i.e., non-matching) lines use ‘<samp><span
class="samp">-</span></samp>’ instead.
- <li>When no context is specified,
+ <li>When context is not specified,
matching lines are simply output one right after another.
- <li>When nonzero context is specified,
+ <li>When context is specified,
lines that are adjacent in the input form a group
and are output one right after another, while
-a separator appears by default between disjoint groups on a line
-of its own and without any prefix.
+by default a separator appears between non-adjacent groups.
<li>The default separator
-is ‘<samp><span class="samp">--</span></samp>’, however whether to
include it and its appearance
+is a ‘<samp><span class="samp">--</span></samp>’ line; its
presence and appearance
can be changed with the options above.
<li>Each group may contain
several matching lines when they are close enough to each other
-that two otherwise adjacent but divided groups connect
-and can just merge into a single contiguous one.
+that two adjacent groups connect and can merge into a single
+contiguous one.
</ul>
<div class="node">
@@ -1429,20 +1439,16 @@
<p>Standard grep cannot do this, as it is fundamentally line-based.
Therefore, merely using the <code>[:space:]</code> character class does not
-match newlines in the way you might expect. However, if your grep is
-compiled with Perl patterns enabled, the Perl ‘<samp><span
class="samp">s</span></samp>’
-modifier (which makes <code>.</code> match newlines) can be used:
+match newlines in the way you might expect.
- <pre class="example"> printf 'foo\nbar\n' | grep -P
'(?s)foo.*?bar'
-</pre>
<p>With the GNU <samp><span class="command">grep</span></samp> option
<code>-z</code> (see <a href="#File-and-Directory-Selection">File and Directory
Selection</a>), the input is terminated by null bytes. Thus,
-you can match newlines in the input, but the output will be the whole
-file, so this is really only useful to determine if the pattern is
-present:
+you can match newlines in the input, but typically if there is a match
+the entire input is output, so this usage is often combined with
+output-suppressing options like <samp><span class="option">-q</span></samp>,
e.g.:
<pre class="example"> printf 'foo\nbar\n' | grep -z -q
'foo[[:space:]]\+bar'
</pre>
- <p>Failing either of those options, you need to transform the input
+ <p>If this does not suffice, you can transform the input
before giving it to <samp><span class="command">grep</span></samp>, or turn to
<samp><span class="command">awk</span></samp>,
<samp><span class="command">sed</span></samp>, <samp><span
class="command">perl</span></samp>, or many other utilities that are
designed to operate across lines.
@@ -2261,3 +2267,10 @@
</body></html>
+<!--
+
+Local Variables:
+coding: utf-8
+End:
+
+-->
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- Changes to grep/manual/grep.html,v,
Jim Meyering <=