Fossil SCM

Improve grep documentation

andygoth 2018-11-08 02:38 trunk
Commit 4af31f11bb6473f4508b75097aa868d2b3964aafc8531101afcdda7a576c4f8f
Parent b45dd1c7b5baa34…
3 files changed +6 -6 +1 +5
~ www/grep.md ~ www/mkindex.tcl ~ www/permutedindex.html
M www/grep.md
+6 -6
--- www/grep.md
+++ www/grep.md
@@ -70,25 +70,25 @@
7070
 | `(X)` | match X
7171
 | <tt>X\|Y</tt>| X or Y
7272
 | `^X` | X occurring at the beginning of a line
7373
 | `X$` | X occurring at the end of a line
7474
 | `.` | Match any single character
75
-| `\c` | Character `c` where `c` is one of <tt>{}()[]\|\*+?.</tt>
75
+| `\c` | Character `c` where `c` is one of <tt>{}()[]\|\*+?.\\</tt>
7676
 | `\c` | C-language escapes for `c` in `afnrtv`. ex: `\t` or `\n`
7777
 | `\uXXXX`| Where XXXX is exactly 4 hex digits, Unicode value XXXX
7878
 | `\xXX` | Where XX is exactly 2 hex digits, Unicode value XX
7979
 | `[abc]` | Any single character from the set `abc`
8080
 | `[^abc]`| Any single character not in the set `abc`
8181
 | `[a-z]` | Any single character in the range `a-z`
8282
 | `[^a-z]`| Any single character not in the range `a-z`
8383
 | `\b` | Word boundary
8484
 | `\w` | Word character: `[A-Za-z0-9_]`
85
-| `\W` | Non-word character
86
-| `\d` | Digit
87
-| `\D` | Non-digit
88
-| `\s` | Whitespace character
89
-| `\S` | Non-whitespace character
85
+| `\W` | Non-word character: `[^A-Za-z0-9_]`
86
+| `\d` | Digit: `[0-9]`
87
+| `\D` | Non-digit: `[^0-9]`
88
+| `\s` | Whitespace character: `[ \t\r\n\v\f]`
89
+| `\S` | Non-whitespace character: `[^ \t\r\n\v\f]`
9090
9191
 There are several restrictions in Fossil `grep` relative to a fully
9292
 POSIX compatible regular expression engine. Among them are:
9393
9494
 * There is currently no support for POSIX character classes such as
9595
--- www/grep.md
+++ www/grep.md
@@ -70,25 +70,25 @@
70 | `(X)` | match X
71 | <tt>X\|Y</tt>| X or Y
72 | `^X` | X occurring at the beginning of a line
73 | `X$` | X occurring at the end of a line
74 | `.` | Match any single character
75 | `\c` | Character `c` where `c` is one of <tt>{}()[]\|\*+?.</tt>
76 | `\c` | C-language escapes for `c` in `afnrtv`. ex: `\t` or `\n`
77 | `\uXXXX`| Where XXXX is exactly 4 hex digits, Unicode value XXXX
78 | `\xXX` | Where XX is exactly 2 hex digits, Unicode value XX
79 | `[abc]` | Any single character from the set `abc`
80 | `[^abc]`| Any single character not in the set `abc`
81 | `[a-z]` | Any single character in the range `a-z`
82 | `[^a-z]`| Any single character not in the range `a-z`
83 | `\b` | Word boundary
84 | `\w` | Word character: `[A-Za-z0-9_]`
85 | `\W` | Non-word character
86 | `\d` | Digit
87 | `\D` | Non-digit
88 | `\s` | Whitespace character
89 | `\S` | Non-whitespace character
90
91 There are several restrictions in Fossil `grep` relative to a fully
92 POSIX compatible regular expression engine. Among them are:
93
94 * There is currently no support for POSIX character classes such as
95
--- www/grep.md
+++ www/grep.md
@@ -70,25 +70,25 @@
70 | `(X)` | match X
71 | <tt>X\|Y</tt>| X or Y
72 | `^X` | X occurring at the beginning of a line
73 | `X$` | X occurring at the end of a line
74 | `.` | Match any single character
75 | `\c` | Character `c` where `c` is one of <tt>{}()[]\|\*+?.\\</tt>
76 | `\c` | C-language escapes for `c` in `afnrtv`. ex: `\t` or `\n`
77 | `\uXXXX`| Where XXXX is exactly 4 hex digits, Unicode value XXXX
78 | `\xXX` | Where XX is exactly 2 hex digits, Unicode value XX
79 | `[abc]` | Any single character from the set `abc`
80 | `[^abc]`| Any single character not in the set `abc`
81 | `[a-z]` | Any single character in the range `a-z`
82 | `[^a-z]`| Any single character not in the range `a-z`
83 | `\b` | Word boundary
84 | `\w` | Word character: `[A-Za-z0-9_]`
85 | `\W` | Non-word character: `[^A-Za-z0-9_]`
86 | `\d` | Digit: `[0-9]`
87 | `\D` | Non-digit: `[^0-9]`
88 | `\s` | Whitespace character: `[ \t\r\n\v\f]`
89 | `\S` | Non-whitespace character: `[^ \t\r\n\v\f]`
90
91 There are several restrictions in Fossil `grep` relative to a fully
92 POSIX compatible regular expression engine. Among them are:
93
94 * There is currently no support for POSIX character classes such as
95
M www/mkindex.tcl
+1
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -42,10 +42,11 @@
4242
 forum.wiki {Fossil Forums}
4343
 foss-cklist.wiki {Checklist For Successful Open-Source Projects}
4444
 fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE}
4545
 fossil-v-git.wiki {Fossil Versus Git}
4646
 globs.md {File Name Glob Patterns}
47
+ grep.md {Fossil grep vs POSIX grep}
4748
 hacker-howto.wiki {Hacker How-To}
4849
 hashpolicy.wiki {Hash Policy: Choosing Between SHA1 and SHA3-256}
4950
 /help {Lists of Commands and Webpages}
5051
 hints.wiki {Fossil Tips And Usage Hints}
5152
 index.wiki {Home Page}
5253
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -42,10 +42,11 @@
42 forum.wiki {Fossil Forums}
43 foss-cklist.wiki {Checklist For Successful Open-Source Projects}
44 fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE}
45 fossil-v-git.wiki {Fossil Versus Git}
46 globs.md {File Name Glob Patterns}
 
47 hacker-howto.wiki {Hacker How-To}
48 hashpolicy.wiki {Hash Policy: Choosing Between SHA1 and SHA3-256}
49 /help {Lists of Commands and Webpages}
50 hints.wiki {Fossil Tips And Usage Hints}
51 index.wiki {Home Page}
52
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -42,10 +42,11 @@
42 forum.wiki {Fossil Forums}
43 foss-cklist.wiki {Checklist For Successful Open-Source Projects}
44 fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE}
45 fossil-v-git.wiki {Fossil Versus Git}
46 globs.md {File Name Glob Patterns}
47 grep.md {Fossil grep vs POSIX grep}
48 hacker-howto.wiki {Hacker How-To}
49 hashpolicy.wiki {Hash Policy: Choosing Between SHA1 and SHA3-256}
50 /help {Lists of Commands and Webpages}
51 hints.wiki {Fossil Tips And Usage Hints}
52 index.wiki {Home Page}
53
M www/permutedindex.html
+5
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -106,10 +106,11 @@
106106
 <li><a href="concepts.wiki"><b>Fossil Core Concepts</b></a></li>
107107
 <li><a href="delta_encoder_algorithm.wiki"><b>Fossil Delta Encoding Algorithm</b></a></li>
108108
 <li><a href="delta_format.wiki"><b>Fossil Delta Format</b></a></li>
109109
 <li><a href="fileformat.wiki"><b>Fossil File Format</b></a></li>
110110
 <li><a href="forum.wiki"><b>Fossil Forums</b></a></li>
111
+<li><a href="grep.md"><b>Fossil grep vs POSIX grep</b></a></li>
111112
 <li><a href="quickstart.wiki"><b>Fossil Quick Start Guide</b></a></li>
112113
 <li><a href="selfcheck.wiki"><b>Fossil Repository Integrity Self Checks</b></a></li>
113114
 <li><a href="selfhost.wiki"><b>Fossil Self Hosting Repositories</b></a></li>
114115
 <li><a href="settings.wiki"><b>Fossil Settings</b></a></li>
115116
 <li><a href="hints.wiki"><b>Fossil Tips And Usage Hints</b></a></li>
@@ -121,10 +122,12 @@
121122
 <li><a href="inout.wiki">Git &mdash; Import And Export To And From</a></li>
122123
 <li><a href="quotes.wiki">Git, and DVCSes in General &mdash; Quotes: What People Are Saying About Fossil,</a></li>
123124
 <li><a href="globs.md">Glob Patterns &mdash; File Name</a></li>
124125
 <li><a href="env-opts.md">Global Options &mdash; Environment Variables and</a></li>
125126
 <li><a href="customgraph.md">Graph &mdash; Theming: Customizing the Timeline</a></li>
127
+<li><a href="grep.md">grep &mdash; Fossil grep vs POSIX</a></li>
128
+<li><a href="grep.md">grep vs POSIX grep &mdash; Fossil</a></li>
126129
 <li><a href="quickstart.wiki">Guide &mdash; Fossil Quick Start</a></li>
127130
 <li><a href="style.wiki">Guidelines &mdash; Source Code Style</a></li>
128131
 <li><a href="hacker-howto.wiki"><b>Hacker How-To</b></a></li>
129132
 <li><a href="adding_code.wiki"><b>Hacking Fossil</b></a></li>
130133
 <li><a href="hashpolicy.wiki"><b>Hash Policy: Choosing Between SHA1 and SHA3-256</b></a></li>
@@ -169,10 +172,11 @@
169172
 <li><a href="password.wiki"><b>Password Management And Authentication</b></a></li>
170173
 <li><a href="globs.md">Patterns &mdash; File Name Glob</a></li>
171174
 <li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes: What</a></li>
172175
 <li><a href="stats.wiki"><b>Performance Statistics</b></a></li>
173176
 <li><a href="hashpolicy.wiki">Policy: Choosing Between SHA1 and SHA3-256 &mdash; Hash</a></li>
177
+<li><a href="grep.md">POSIX grep &mdash; Fossil grep vs</a></li>
174178
 <li><a href="../test/release-checklist.wiki"><b>Pre-Release Testing Checklist</b></a></li>
175179
 <li><a href="pop.wiki"><b>Principles Of Operation</b></a></li>
176180
 <li><a href="private.wiki">Private Branches &mdash; Creating, Syncing, and Deleting</a></li>
177181
 <li><a href="makefile.wiki">Process &mdash; The Fossil Build</a></li>
178182
 <li><a href="contribute.wiki">Project &mdash; Contributing Code or Documentation To The Fossil</a></li>
@@ -242,10 +246,11 @@
242246
 <li><a href="ssl.wiki"><b>Using SSL with Fossil</b></a></li>
243247
 <li><a href="env-opts.md">Variables and Global Options &mdash; Environment</a></li>
244248
 <li><a href="whyusefossil.wiki">Version Control &mdash; Benefits Of</a></li>
245249
 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
246250
 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
251
+<li><a href="grep.md">vs POSIX grep &mdash; Fossil grep</a></li>
247252
 <li><a href="webui.wiki">Web Interface &mdash; The Fossil</a></li>
248253
 <li><a href="customskin.md">Web Pages &mdash; Theming: Customizing The Appearance of</a></li>
249254
 <li><a href="webpage-ex.md"><b>Webpage Examples</b></a></li>
250255
 <li><a href="../../../help">Webpages &mdash; Lists of Commands and</a></li>
251256
 <li><a href="quotes.wiki">What People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes:</a></li>
252257
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -106,10 +106,11 @@
106 <li><a href="concepts.wiki"><b>Fossil Core Concepts</b></a></li>
107 <li><a href="delta_encoder_algorithm.wiki"><b>Fossil Delta Encoding Algorithm</b></a></li>
108 <li><a href="delta_format.wiki"><b>Fossil Delta Format</b></a></li>
109 <li><a href="fileformat.wiki"><b>Fossil File Format</b></a></li>
110 <li><a href="forum.wiki"><b>Fossil Forums</b></a></li>
 
111 <li><a href="quickstart.wiki"><b>Fossil Quick Start Guide</b></a></li>
112 <li><a href="selfcheck.wiki"><b>Fossil Repository Integrity Self Checks</b></a></li>
113 <li><a href="selfhost.wiki"><b>Fossil Self Hosting Repositories</b></a></li>
114 <li><a href="settings.wiki"><b>Fossil Settings</b></a></li>
115 <li><a href="hints.wiki"><b>Fossil Tips And Usage Hints</b></a></li>
@@ -121,10 +122,12 @@
121 <li><a href="inout.wiki">Git &mdash; Import And Export To And From</a></li>
122 <li><a href="quotes.wiki">Git, and DVCSes in General &mdash; Quotes: What People Are Saying About Fossil,</a></li>
123 <li><a href="globs.md">Glob Patterns &mdash; File Name</a></li>
124 <li><a href="env-opts.md">Global Options &mdash; Environment Variables and</a></li>
125 <li><a href="customgraph.md">Graph &mdash; Theming: Customizing the Timeline</a></li>
 
 
126 <li><a href="quickstart.wiki">Guide &mdash; Fossil Quick Start</a></li>
127 <li><a href="style.wiki">Guidelines &mdash; Source Code Style</a></li>
128 <li><a href="hacker-howto.wiki"><b>Hacker How-To</b></a></li>
129 <li><a href="adding_code.wiki"><b>Hacking Fossil</b></a></li>
130 <li><a href="hashpolicy.wiki"><b>Hash Policy: Choosing Between SHA1 and SHA3-256</b></a></li>
@@ -169,10 +172,11 @@
169 <li><a href="password.wiki"><b>Password Management And Authentication</b></a></li>
170 <li><a href="globs.md">Patterns &mdash; File Name Glob</a></li>
171 <li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes: What</a></li>
172 <li><a href="stats.wiki"><b>Performance Statistics</b></a></li>
173 <li><a href="hashpolicy.wiki">Policy: Choosing Between SHA1 and SHA3-256 &mdash; Hash</a></li>
 
174 <li><a href="../test/release-checklist.wiki"><b>Pre-Release Testing Checklist</b></a></li>
175 <li><a href="pop.wiki"><b>Principles Of Operation</b></a></li>
176 <li><a href="private.wiki">Private Branches &mdash; Creating, Syncing, and Deleting</a></li>
177 <li><a href="makefile.wiki">Process &mdash; The Fossil Build</a></li>
178 <li><a href="contribute.wiki">Project &mdash; Contributing Code or Documentation To The Fossil</a></li>
@@ -242,10 +246,11 @@
242 <li><a href="ssl.wiki"><b>Using SSL with Fossil</b></a></li>
243 <li><a href="env-opts.md">Variables and Global Options &mdash; Environment</a></li>
244 <li><a href="whyusefossil.wiki">Version Control &mdash; Benefits Of</a></li>
245 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
246 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
 
247 <li><a href="webui.wiki">Web Interface &mdash; The Fossil</a></li>
248 <li><a href="customskin.md">Web Pages &mdash; Theming: Customizing The Appearance of</a></li>
249 <li><a href="webpage-ex.md"><b>Webpage Examples</b></a></li>
250 <li><a href="../../../help">Webpages &mdash; Lists of Commands and</a></li>
251 <li><a href="quotes.wiki">What People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes:</a></li>
252
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -106,10 +106,11 @@
106 <li><a href="concepts.wiki"><b>Fossil Core Concepts</b></a></li>
107 <li><a href="delta_encoder_algorithm.wiki"><b>Fossil Delta Encoding Algorithm</b></a></li>
108 <li><a href="delta_format.wiki"><b>Fossil Delta Format</b></a></li>
109 <li><a href="fileformat.wiki"><b>Fossil File Format</b></a></li>
110 <li><a href="forum.wiki"><b>Fossil Forums</b></a></li>
111 <li><a href="grep.md"><b>Fossil grep vs POSIX grep</b></a></li>
112 <li><a href="quickstart.wiki"><b>Fossil Quick Start Guide</b></a></li>
113 <li><a href="selfcheck.wiki"><b>Fossil Repository Integrity Self Checks</b></a></li>
114 <li><a href="selfhost.wiki"><b>Fossil Self Hosting Repositories</b></a></li>
115 <li><a href="settings.wiki"><b>Fossil Settings</b></a></li>
116 <li><a href="hints.wiki"><b>Fossil Tips And Usage Hints</b></a></li>
@@ -121,10 +122,12 @@
122 <li><a href="inout.wiki">Git &mdash; Import And Export To And From</a></li>
123 <li><a href="quotes.wiki">Git, and DVCSes in General &mdash; Quotes: What People Are Saying About Fossil,</a></li>
124 <li><a href="globs.md">Glob Patterns &mdash; File Name</a></li>
125 <li><a href="env-opts.md">Global Options &mdash; Environment Variables and</a></li>
126 <li><a href="customgraph.md">Graph &mdash; Theming: Customizing the Timeline</a></li>
127 <li><a href="grep.md">grep &mdash; Fossil grep vs POSIX</a></li>
128 <li><a href="grep.md">grep vs POSIX grep &mdash; Fossil</a></li>
129 <li><a href="quickstart.wiki">Guide &mdash; Fossil Quick Start</a></li>
130 <li><a href="style.wiki">Guidelines &mdash; Source Code Style</a></li>
131 <li><a href="hacker-howto.wiki"><b>Hacker How-To</b></a></li>
132 <li><a href="adding_code.wiki"><b>Hacking Fossil</b></a></li>
133 <li><a href="hashpolicy.wiki"><b>Hash Policy: Choosing Between SHA1 and SHA3-256</b></a></li>
@@ -169,10 +172,11 @@
172 <li><a href="password.wiki"><b>Password Management And Authentication</b></a></li>
173 <li><a href="globs.md">Patterns &mdash; File Name Glob</a></li>
174 <li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes: What</a></li>
175 <li><a href="stats.wiki"><b>Performance Statistics</b></a></li>
176 <li><a href="hashpolicy.wiki">Policy: Choosing Between SHA1 and SHA3-256 &mdash; Hash</a></li>
177 <li><a href="grep.md">POSIX grep &mdash; Fossil grep vs</a></li>
178 <li><a href="../test/release-checklist.wiki"><b>Pre-Release Testing Checklist</b></a></li>
179 <li><a href="pop.wiki"><b>Principles Of Operation</b></a></li>
180 <li><a href="private.wiki">Private Branches &mdash; Creating, Syncing, and Deleting</a></li>
181 <li><a href="makefile.wiki">Process &mdash; The Fossil Build</a></li>
182 <li><a href="contribute.wiki">Project &mdash; Contributing Code or Documentation To The Fossil</a></li>
@@ -242,10 +246,11 @@
246 <li><a href="ssl.wiki"><b>Using SSL with Fossil</b></a></li>
247 <li><a href="env-opts.md">Variables and Global Options &mdash; Environment</a></li>
248 <li><a href="whyusefossil.wiki">Version Control &mdash; Benefits Of</a></li>
249 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
250 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
251 <li><a href="grep.md">vs POSIX grep &mdash; Fossil grep</a></li>
252 <li><a href="webui.wiki">Web Interface &mdash; The Fossil</a></li>
253 <li><a href="customskin.md">Web Pages &mdash; Theming: Customizing The Appearance of</a></li>
254 <li><a href="webpage-ex.md"><b>Webpage Examples</b></a></li>
255 <li><a href="../../../help">Webpages &mdash; Lists of Commands and</a></li>
256 <li><a href="quotes.wiki">What People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes:</a></li>
257

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button