summaryrefslogtreecommitdiffstats
path: root/man/repo-grep.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/repo-grep.1')
-rw-r--r--man/repo-grep.1118
1 files changed, 118 insertions, 0 deletions
diff --git a/man/repo-grep.1 b/man/repo-grep.1
new file mode 100644
index 00000000..fb515a7b
--- /dev/null
+++ b/man/repo-grep.1
@@ -0,0 +1,118 @@
1.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
2.TH REPO "1" "July 2021" "repo grep" "Repo Manual"
3.SH NAME
4repo \- repo grep - manual page for repo grep
5.SH SYNOPSIS
6.B repo
7\fI\,grep {pattern | -e pattern} \/\fR[\fI\,<project>\/\fR...]
8.SH DESCRIPTION
9Summary
10.PP
11Print lines matching a pattern
12.SH OPTIONS
13.TP
14\fB\-h\fR, \fB\-\-help\fR
15show this help message and exit
16.TP
17\fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR
18number of jobs to run in parallel (default: 4)
19.SS Logging options:
20.TP
21\fB\-\-verbose\fR
22show all output
23.TP
24\fB\-q\fR, \fB\-\-quiet\fR
25only show errors
26.SS Sources:
27.TP
28\fB\-\-cached\fR
29Search the index, instead of the work tree
30.TP
31\fB\-r\fR TREEish, \fB\-\-revision\fR=\fI\,TREEish\/\fR
32Search TREEish, instead of the work tree
33.SS Pattern:
34.TP
35\fB\-e\fR PATTERN
36Pattern to search for
37.TP
38\fB\-i\fR, \fB\-\-ignore\-case\fR
39Ignore case differences
40.TP
41\fB\-a\fR, \fB\-\-text\fR
42Process binary files as if they were text
43.TP
44\fB\-I\fR
45Don't match the pattern in binary files
46.TP
47\fB\-w\fR, \fB\-\-word\-regexp\fR
48Match the pattern only at word boundaries
49.TP
50\fB\-v\fR, \fB\-\-invert\-match\fR
51Select non\-matching lines
52.TP
53\fB\-G\fR, \fB\-\-basic\-regexp\fR
54Use POSIX basic regexp for patterns (default)
55.TP
56\fB\-E\fR, \fB\-\-extended\-regexp\fR
57Use POSIX extended regexp for patterns
58.TP
59\fB\-F\fR, \fB\-\-fixed\-strings\fR
60Use fixed strings (not regexp) for pattern
61.SS Pattern Grouping:
62.TP
63\fB\-\-all\-match\fR
64Limit match to lines that have all patterns
65.TP
66\fB\-\-and\fR, \fB\-\-or\fR, \fB\-\-not\fR
67Boolean operators to combine patterns
68.TP
69\-(, \-)
70Boolean operator grouping
71.SS Output:
72.TP
73\fB\-n\fR
74Prefix the line number to matching lines
75.TP
76\fB\-C\fR CONTEXT
77Show CONTEXT lines around match
78.TP
79\fB\-B\fR CONTEXT
80Show CONTEXT lines before match
81.TP
82\fB\-A\fR CONTEXT
83Show CONTEXT lines after match
84.TP
85\fB\-l\fR, \fB\-\-name\-only\fR, \fB\-\-files\-with\-matches\fR
86Show only file names containing matching lines
87.TP
88\fB\-L\fR, \fB\-\-files\-without\-match\fR
89Show only file names not containing matching lines
90.PP
91Run `repo help grep` to view the detailed manual.
92.SH DETAILS
93.PP
94Search for the specified patterns in all project files.
95.PP
96Boolean Options
97.PP
98The following options can appear as often as necessary to express the pattern to
99locate:
100.HP
101\fB\-e\fR PATTERN
102.HP
103\fB\-\-and\fR, \fB\-\-or\fR, \fB\-\-not\fR, \-(, \-)
104.PP
105Further, the \fB\-r\fR/\-\-revision option may be specified multiple times in order to
106scan multiple trees. If the same file matches in more than one tree, only the
107first result is reported, prefixed by the revision name it was found under.
108.PP
109Examples
110.PP
111Look for a line that has '#define' and either 'MAX_PATH or 'PATH_MAX':
112.IP
113repo grep \fB\-e\fR '#define' \fB\-\-and\fR \-\e( \fB\-e\fR MAX_PATH \fB\-e\fR PATH_MAX \e)
114.PP
115Look for a line that has 'NODE' or 'Unexpected' in files that contain a line
116that matches both expressions:
117.IP
118repo grep \fB\-\-all\-match\fR \fB\-e\fR NODE \fB\-e\fR Unexpected