|
| From: | Jim Meyering |
| Subject: | Changes to grep/manual/grep.txt,v |
| Date: | Sat, 13 May 2023 05:23:54 -0400 (EDT) |
CVSROOT: /webcvs/grep
Module name: grep
Changes by: Jim Meyering <meyering> 23/05/13 05:23:53
Index: grep.txt
===================================================================
RCS file: /webcvs/grep/grep/manual/grep.txt,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -b -r1.34 -r1.35
--- grep.txt 23 Mar 2023 02:55:19 -0000 1.34
+++ grep.txt 13 May 2023 09:23:48 -0000 1.35
@@ -34,7 +34,7 @@
âgrepâ prints lines that contain a match for one or more patterns.
- This manual is for version 3.10 of GNU Grep.
+ This manual is for version 3.11 of GNU Grep.
This manual is for âgrepâ, a pattern matching engine.
@@ -116,9 +116,9 @@
â--file=FILEâ
Obtain patterns from FILE, one per line. If this option is used
multiple times or is combined with the â-eâ (â--regexpâ) option,
- search for all patterns given. The empty file contains zero
- patterns, and therefore matches nothing. (â-fâ is specified by
- POSIX.)
+ search for all patterns given. When FILE is â-â, read patterns
+ from standard input. The empty file contains zero patterns, and
+ therefore matches nothing. (â-fâ is specified by POSIX.)
â-iâ
â-yâ
@@ -766,18 +766,15 @@
caveats:
⢠â\dâ matches only the ten ASCII digits (and â\Dâ matches
the
complement), regardless of locale. Use â\p{Nd}â to also match
- non-ASCII digits.
-
- When âgrepâ is built with PCRE2 10.42 and earlier, â\dâ and
- â\Dâ ignore in-regexp directives like â(?aD)â and work like
- â[0-9]â and â[^0-9]â respectively. However, later versions
of
- PCRE2 likely will fix this, and the plan is for âgrepâ to
- respect those directives if possible.
+ non-ASCII digits. (The behavior of â\dâ and â\Dâ is
+ unspecified after in-regexp directives like â(?aD)â.)
⢠Although PCRE tracks the syntax and semantics of Perl's
- regular expressions, the match is not always exact, partly
- because Perl evolves and a Perl installation may predate or
- postdate the PCRE2 installation on the same host.
+ regular expressions, the match is not always exact. For
+ example, Perl evolves and a Perl installation may predate or
+ postdate the PCRE2 installation on the same host, or their
+ Unicode versions may differ, or Perl and PCRE2 may disagree
+ about an obscure construct.
⢠By default, âgrepâ applies each regexp to a line at a time, so
the â(?s)â directive (making â.â match line breaks) is
@@ -1484,8 +1481,8 @@
obsolescence warnings by GNU Grep 3.8 in 2022; eventually, they are
planned to be removed entirely.
- If you prefer the old names, you can use use your own substitutes,
- such as a shell script named âegrepâ with the following contents:
+ If you prefer the old names, you can use your own substitutes, such
+ as a shell script named âegrepâ with the following contents:
#!/bin/sh
exec grep -E "$@"
@@ -2268,42 +2265,42 @@
(line 319)
* -z: Other Options. (line 534)
* ?: Fundamental Structure.
- (line 827)
+ (line 824)
* .: Fundamental Structure.
- (line 819)
+ (line 816)
* {,M}: Fundamental Structure.
- (line 842)
-* {N,}: Fundamental Structure.
(line 839)
+* {N,}: Fundamental Structure.
+ (line 836)
* {N,M}: Fundamental Structure.
- (line 846)
+ (line 843)
* {N}: Fundamental Structure.
- (line 836)
+ (line 833)
* *: Fundamental Structure.
- (line 830)
+ (line 827)
* +: Fundamental Structure.
- (line 833)
+ (line 830)
* after context: Context Line Control.
(line 340)
* alnum character class: Character Classes and Bracket
Expressions.
- (line 895)
+ (line 892)
* alpha character class: Character Classes and Bracket
Expressions.
- (line 900)
+ (line 897)
* alphabetic characters: Character Classes and Bracket
Expressions.
- (line 900)
+ (line 897)
* alphanumeric characters: Character Classes and Bracket
Expressions.
- (line 895)
+ (line 892)
* alternatives in regular expressions: Fundamental Structure.
- (line 854)
-* anchoring: Anchoring. (line 1036)
+ (line 851)
+* anchoring: Anchoring. (line 1033)
* asterisk: Fundamental Structure.
- (line 830)
+ (line 827)
* back-reference: Back-references and Subexpressions.
- (line 1044)
-* back-references: Performance. (line 1530)
+ (line 1041)
+* back-references: Performance. (line 1527)
* backslash: Special Backslash Expressions.
- (line 990)
-* basic regular expressions: Basic vs Extended. (line 1060)
+ (line 987)
+* basic regular expressions: Basic vs Extended. (line 1057)
* before context: Context Line Control.
(line 344)
* binary files: File and Directory Selection.
@@ -2312,40 +2309,40 @@
(line 390)
* binary I/O: Other Options. (line 513)
* blank character class: Character Classes and Bracket
Expressions.
- (line 905)
+ (line 902)
* blank characters: Character Classes and Bracket
Expressions.
- (line 905)
+ (line 902)
* bn GREP_COLORS capability: Environment Variables.
(line 653)
* braces, first argument omitted: Fundamental Structure.
- (line 842)
+ (line 839)
* braces, one argument: Fundamental Structure.
- (line 836)
+ (line 833)
* braces, second argument omitted: Fundamental Structure.
- (line 839)
+ (line 836)
* braces, two arguments: Fundamental Structure.
- (line 846)
+ (line 843)
* bracket expression: Character Classes and Bracket
Expressions.
- (line 869)
-* Bugs, known: Known Bugs. (line 1601)
-* bugs, reporting: Reporting Bugs. (line 1593)
+ (line 866)
+* Bugs, known: Known Bugs. (line 1598)
+* bugs, reporting: Reporting Bugs. (line 1590)
* byte offset: Output Line Prefix Control.
(line 281)
* case insensitive search: Matching Control. (line 125)
-* case insensitive search <1>: Performance. (line 1516)
+* case insensitive search <1>: Performance. (line 1513)
* changing name of standard input: Output Line Prefix Control.
(line 297)
* character class: Character Classes and Bracket
Expressions.
- (line 869)
+ (line 866)
* character classes: Character Classes and Bracket
Expressions.
- (line 894)
-* character encoding: Character Encoding. (line 1198)
+ (line 891)
+* character encoding: Character Encoding. (line 1195)
* character type: Environment Variables.
(line 680)
* classes of characters: Character Classes and Bracket
Expressions.
- (line 894)
+ (line 891)
* cntrl character class: Character Classes and Bracket
Expressions.
- (line 908)
+ (line 905)
* context lines: General Output Control.
(line 244)
* context lines <1>: Context Line Control.
@@ -2357,8 +2354,8 @@
* context lines, before match: Context Line Control.
(line 344)
* control characters: Character Classes and Bracket
Expressions.
- (line 908)
-* copying: Copying. (line 1621)
+ (line 905)
+* copying: Copying. (line 1618)
* counting lines: General Output Control.
(line 182)
* cx GREP_COLORS capability: Environment Variables.
@@ -2366,13 +2363,13 @@
* device search: File and Directory Selection.
(line 429)
* digit character class: Character Classes and Bracket
Expressions.
- (line 913)
+ (line 910)
* digit characters: Character Classes and Bracket
Expressions.
- (line 913)
+ (line 910)
* directory search: File and Directory Selection.
(line 440)
* dot: Fundamental Structure.
- (line 819)
+ (line 816)
* encoding error: Environment Variables.
(line 687)
* environment variables: Environment Variables.
@@ -2384,7 +2381,7 @@
* exclude files <1>: File and Directory Selection.
(line 461)
* exit status: Exit Status. (line 725)
-* FAQ about grep usage: Usage. (line 1282)
+* FAQ about grep usage: Usage. (line 1279)
* files which don't match: General Output Control.
(line 207)
* fn GREP_COLORS capability: Environment Variables.
@@ -2392,9 +2389,9 @@
* fn GREP_COLORS capability <1>: Environment Variables.
(line 658)
* graph character class: Character Classes and Bracket
Expressions.
- (line 916)
+ (line 913)
* graphic characters: Character Classes and Bracket
Expressions.
- (line 916)
+ (line 913)
* grep programs: grep Programs. (line 734)
* GREP_COLOR environment variable: Environment Variables.
(line 563)
@@ -2405,21 +2402,21 @@
* group separator <1>: Context Line Control.
(line 356)
* hexadecimal digits: Character Classes and Bracket
Expressions.
- (line 940)
+ (line 937)
* highlight markers: Environment Variables.
(line 563)
* highlight markers <1>: Environment Variables.
(line 569)
* highlight, color, colour: General Output Control.
(line 188)
-* holes in files: Performance. (line 1540)
+* holes in files: Performance. (line 1537)
* include files: File and Directory Selection.
(line 475)
* interval expressions: Fundamental Structure.
- (line 822)
-* interval expressions <1>: Performance. (line 1521)
+ (line 819)
+* interval expressions <1>: Performance. (line 1518)
* invalid regular expressions: Problematic Expressions.
- (line 1085)
+ (line 1082)
* invert matching: Matching Control. (line 150)
* LANG environment variable: Environment Variables.
(line 546)
@@ -2456,25 +2453,25 @@
(line 305)
* ln GREP_COLORS capability: Environment Variables.
(line 648)
-* locales: Performance. (line 1509)
+* locales: Performance. (line 1506)
* lower character class: Character Classes and Bracket
Expressions.
- (line 919)
+ (line 916)
* lower-case letters: Character Classes and Bracket
Expressions.
- (line 919)
+ (line 916)
* match expression at most M times: Fundamental Structure.
- (line 842)
+ (line 839)
* match expression at most once: Fundamental Structure.
- (line 827)
+ (line 824)
* match expression from N to M times: Fundamental Structure.
- (line 846)
+ (line 843)
* match expression N or more times: Fundamental Structure.
- (line 839)
-* match expression N times: Fundamental Structure.
(line 836)
-* match expression one or more times: Fundamental Structure.
+* match expression N times: Fundamental Structure.
(line 833)
-* match expression zero or more times: Fundamental Structure.
+* match expression one or more times: Fundamental Structure.
(line 830)
+* match expression zero or more times: Fundamental Structure.
+ (line 827)
* match the whole line: Matching Control. (line 172)
* matching basic regular expressions: grep Programs. (line 743)
* matching extended regular expressions: grep Programs. (line 748)
@@ -2505,48 +2502,48 @@
(line 680)
* no filename prefix: Output Line Prefix Control.
(line 292)
-* non-ASCII matching: Matching Non-ASCII. (line 1223)
-* non-printable matching: Matching Non-ASCII. (line 1223)
+* non-ASCII matching: Matching Non-ASCII. (line 1220)
+* non-printable matching: Matching Non-ASCII. (line 1220)
* null character: Environment Variables.
(line 687)
* numeric characters: Character Classes and Bracket
Expressions.
- (line 913)
+ (line 910)
* only matching: General Output Control.
(line 252)
* option delimiter: Other Options. (line 498)
* ordinary characters: Fundamental Structure.
- (line 814)
+ (line 811)
* patterns from file: Matching Control. (line 116)
* patterns option: Matching Control. (line 107)
-* performance: Performance. (line 1495)
+* performance: Performance. (line 1492)
* period: Fundamental Structure.
- (line 819)
-* pipelines and reading: Performance. (line 1548)
+ (line 816)
+* pipelines and reading: Performance. (line 1545)
* plus sign: Fundamental Structure.
- (line 833)
+ (line 830)
* POSIXLY_CORRECT environment variable: Environment Variables.
(line 701)
* print character class: Character Classes and Bracket
Expressions.
- (line 923)
+ (line 920)
* print non-matching lines: Matching Control. (line 150)
* printable characters: Character Classes and Bracket
Expressions.
- (line 923)
+ (line 920)
* punct character class: Character Classes and Bracket
Expressions.
- (line 926)
+ (line 923)
* punctuation characters: Character Classes and Bracket
Expressions.
- (line 926)
+ (line 923)
* question mark: Fundamental Structure.
- (line 827)
+ (line 824)
* quiet, silent: General Output Control.
(line 260)
* range expression: Character Classes and Bracket
Expressions.
- (line 877)
+ (line 874)
* recursive search: File and Directory Selection.
(line 483)
* recursive search <1>: File and Directory Selection.
(line 491)
* regular expressions: Regular Expressions.
- (line 796)
+ (line 793)
* return status: Exit Status. (line 725)
* rv GREP_COLORS capability: Environment Variables.
(line 613)
@@ -2564,13 +2561,13 @@
* sl GREP_COLORS capability: Environment Variables.
(line 596)
* space character class: Character Classes and Bracket
Expressions.
- (line 931)
+ (line 928)
* space characters: Character Classes and Bracket
Expressions.
- (line 931)
+ (line 928)
* special characters: Fundamental Structure.
- (line 814)
+ (line 811)
* subexpression: Back-references and Subexpressions.
- (line 1044)
+ (line 1041)
* suppress binary data: File and Directory Selection.
(line 386)
* suppress error messages: General Output Control.
@@ -2588,26 +2585,26 @@
* translation of message language: Environment Variables.
(line 696)
* unspecified behavior in regular expressions: Problematic Expressions.
- (line 1085)
+ (line 1082)
* upper character class: Character Classes and Bracket
Expressions.
- (line 936)
+ (line 933)
* upper-case letters: Character Classes and Bracket
Expressions.
- (line 936)
+ (line 933)
* usage summary, printing: Generic Program Information.
(line 94)
-* usage, examples: Usage. (line 1256)
-* using grep, Q&A: Usage. (line 1282)
+* usage, examples: Usage. (line 1253)
+* using grep, Q&A: Usage. (line 1279)
* variants of grep: grep Programs. (line 734)
* version, printing: Generic Program Information.
(line 99)
* whitespace characters: Character Classes and Bracket
Expressions.
- (line 931)
+ (line 928)
* with filename prefix: Output Line Prefix Control.
(line 287)
* xdigit character class: Character Classes and Bracket
Expressions.
- (line 940)
+ (line 937)
* xdigit class: Character Classes and Bracket
Expressions.
- (line 940)
+ (line 937)
* zero-terminated file names: Output Line Prefix Control.
(line 319)
* zero-terminated lines: Other Options. (line 534)
| [Prev in Thread] | Current Thread | [Next in Thread] |