Merge from emacs-24; up to 2013-01-02T16:37:04Z!eggert@cs.ucla.edu
[bpt/emacs.git] / etc / grep.txt
1 * Introduction -*-grep-*- (See the end of file for copyright information)
2
3 This shows the different kinds of messages grep recognizes by default and
4 how they are rendered. It is intended both to help you decide which matchers
5 you need and as a test of the matchers. Move the mouse over a colored part
6 to see how much text was actually matched.
7
8 Please do not edit this file in grep-mode, it may lose escape
9 sequences on saving. Visit this file literally for editing.
10
11
12 * GNU grep 2.5.1
13
14 grep -nH -e "INFO tree" ../info/*
15 ../info/dir:6:File: dir Node: Top This is the top of the INFO tree
16
17 * GNU grep 2.5.1 with default colors
18
19 grep -nH --color=always -e "INFO tree" ../info/*
20 ../info/dir:6:File: dir Node: Top This is the top of the \e[01;31mINFO tree\e[00m
21
22 * GNU grep 2.5.1-cvs with the specified matching color
23
24 GREP_COLORS='mt=01;31:fn=:ln=:bn=:se=:ml=:cx=:ne' grep -nH --color=always -e "INFO tree" ../info/*
25 ../info/dir:6:File: dir Node: Top This is the top of the \e[01;31mINFO tree\e[m
26
27 * GNU grep 2.5.1-cvs with colors for the file name, line number and match
28
29 GREP_COLORS='mt=01;31:fn=35:ln=32:bn=:se=:ml=36:cx=37:ne' grep -nH --color=always -e "INFO tree" ../info/*
30 \e[35m../info/dir\e[m:\e[32m6\e[m:\e[36mFile: dir Node: Top This is the top of the \e[01;31mINFO tree\e[m
31 \e[35m1\e[m:\e[32m2\e[m:\e[36m3:4:\e[01;31mtext\e[m
32 \e[35m1:2\e[m:\e[32m3\e[m:\e[36m4:\e[01;31mtext\e[m
33 \e[35m1:2:3\e[m:\e[32m4\e[m:\e[36m\e[01;31mtext\e[m
34
35 * GNU grep 2.5.1-cvs with default colors
36
37 grep -nH --color=always -e "INFO tree" ../info/*
38 \e[35m\e[K../info/dir\e[m\e[K\e[36m\e[K:\e[m\e[K\e[32m\e[K6\e[m\e[K\e[36m\e[K:\e[m\e[KFile: dir Node: Top This is the top of the \e[01;31m\e[KINFO tree\e[m\e[K
39
40 * GNU grep 2.5.1 on lines starting with a number and colon
41
42 grep -nH -e "Universal Time" ../lispref/*
43 ../lispref/os.texi:1010:0:00 January 1, 1970 UTC (Coordinated \e[01;31mUniversal Time\e[00m)
44
45 * GNU grep 2.5.1 with context lines
46
47 grep -C 2 -nH --color=always -e "INFO tree" ../info/*
48 ../info/dir-4-looking at that node, which is (dir)Top.
49 ../info/dir-5-\1f
50 ../info/dir:6:File: dir Node: Top This is the top of the \e[01;31mINFO tree\e[00m
51 ../info/dir-7-
52 ../info/dir-8-The Info Directory
53
54 * GNU grep 2.5.1 on files recognized as binary
55
56 Binary file emacs-7 matches
57 Binary file 2005-06 matches
58
59 * GNU grep 2.5.1: other messages
60
61 Grep started at Tue Jul 19 15:41:30
62 grep: ../info/dirinfo: No such file or directory
63 Grep interrupt at Tue Jul 19 15:42:31
64 Grep killed at Tue Jul 19 15:42:31
65 Grep terminated at Tue Jul 19 15:42:31
66 Grep exited abnormally with code 2 at Tue Jul 19 15:42:31
67 Grep finished with no matches found at Tue Jul 19 15:43:12
68 Grep finished (matches found) at Thu Jul 21 15:02:15
69
70 * agrep
71
72 agrep -n "INFO tree" ../info/*
73 ../info/dir: 6: File: dir Node: Top This is the top of the INFO tree
74
75 * git-grep
76 with `[diff "el"] xfuncname = "^(\\(.*)$"' in .gitconfig
77 and `*.el diff=el' in .gitattributes
78
79 git grep -inH -p -e "org-element-map"
80 lisp/org/org.el=20969=(defun org-fill-paragraph (&optional justify)
81 lisp/org/org.el:21047: (org-element-map
82
83 * unknown greps
84
85 grep -nH -e "xyzxyz" ../info/*
86 ../info/emacs-2:1205:10:inserts `xyzxyzxyzxyz' in the current buffer.
87 ../info/emacs-2:1205:10-15:inserts `xyzxyzxyzxyz' in the current buffer.
88 ../info/emacs-2:1205.10-1205.15:inserts `xyzxyzxyzxyz' in the current buffer.
89 ../info/emacs-2 1205.10-15 inserts `xyzxyzxyzxyz' in the current buffer.
90 ../info/emacs-2 1205.10-1205.15 inserts `xyzxyzxyzxyz' in the current buffer.
91 ../info/emacs-2 1205 inserts `xyzxyzxyzxyz' in the current buffer.
92
93 \f
94
95 Copyright (C) 2005-2013 Free Software Foundation, Inc.
96
97 COPYING PERMISSIONS:
98
99 This document is free software: you can redistribute it and/or modify
100 it under the terms of the GNU General Public License as published by
101 the Free Software Foundation, either version 3 of the License, or
102 (at your option) any later version.
103
104 This program is distributed in the hope that it will be useful,
105 but WITHOUT ANY WARRANTY; without even the implied warranty of
106 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
107 GNU General Public License for more details.
108
109 You should have received a copy of the GNU General Public License
110 along with this program. If not, see <http://www.gnu.org/licenses/>.
111
112
113 ;;; Local Variables:
114 ;;; eval: (let ((inhibit-read-only t) (compilation-filter-start (point-min))) (save-excursion (goto-char (point-max)) (grep-filter) (set-buffer-modified-p nil)))
115 ;;; buffer-read-only: t
116 ;;; End: