Fossil

Check-in [9fc411ab]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Added a spec reference to POSIX grep, and fixed a typo.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 9fc411ab58e4dac411315c5d5828599efafcee6a861907efa6b81c5a48dc941c
User & Date: wyoung 2018-10-03 21:11:58.931
Context
2018-10-03
21:25
Listed the actual differences between fossil grep options and those defined by POSIX in www/grep.md. ... (check-in: d5499091 user: wyoung tags: trunk)
21:11
Added a spec reference to POSIX grep, and fixed a typo. ... (check-in: 9fc411ab user: wyoung tags: trunk)
20:20
Expanded a few of the sections in the new www/grep.md doc ... (check-in: f984d331 user: wyoung tags: trunk)
Changes
Unified Diff Ignore Whitespace Patch
Changes to www/grep.md.
1
2
3
4
5

6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# Fossil grep vs POSIX grep

As of Fossil 2.7, there is a `grep` command which acts roughly like
POSIX's `grep -E` over all historical versions of a single file name.
This document explains the commonalities and divergences between POSIX

`grep` and Fossil `grep`.


## Options

Fossil `grep` supports only a small subset of the options specified for
POSIX `grep`:

| Option | Meaning
|--------|-------------------------------------------------------------
| `-i`   | ignore case in matches
| `-l`   | list a checkin ID prefix for matching historical versions of the file
| `-v`   | print each checkin ID considered, regardless of whether it matches

No equivalent of other POSIX `grep` options currently exist.

Note in partcicular that there is no equivalent of `grep -R`, either
implicitly or explicitly. Fossil `grep` currently accepts only a single
input file name. You cannot give it a list of file names, and you cannot
give it a a directory name for Fossil to expand to the set of all files
under that directory.

Patches to remove those limitations will be thoughtfully considered.


## Regular Expression Dialect





|
>
|


















|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Fossil grep vs POSIX grep

As of Fossil 2.7, there is a `grep` command which acts roughly like
POSIX's `grep -E` over all historical versions of a single file name.
This document explains the commonalities and divergences between [POSIX
`grep`](http://pubs.opengroup.org/onlinepubs/9699919799/utilities/grep.html)
and Fossil `grep`.


## Options

Fossil `grep` supports only a small subset of the options specified for
POSIX `grep`:

| Option | Meaning
|--------|-------------------------------------------------------------
| `-i`   | ignore case in matches
| `-l`   | list a checkin ID prefix for matching historical versions of the file
| `-v`   | print each checkin ID considered, regardless of whether it matches

No equivalent of other POSIX `grep` options currently exist.

Note in partcicular that there is no equivalent of `grep -R`, either
implicitly or explicitly. Fossil `grep` currently accepts only a single
input file name. You cannot give it a list of file names, and you cannot
give it a directory name for Fossil to expand to the set of all files
under that directory.

Patches to remove those limitations will be thoughtfully considered.


## Regular Expression Dialect