This file is indexed.

/usr/share/doc/gnat-gps/html/Defining-new-search-patterns.html is in gnat-gps-doc 5.0-16.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2002-2010 AdaCore.

This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, see http://www.gnu.org/licenses/.

A copy of the license is included in the section entitled
"GNU General Public License". -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Using the GNAT Programming Studio: Defining new search patterns</title>

<meta name="description" content="Using the GNAT Programming Studio: Defining new search patterns">
<meta name="keywords" content="Using the GNAT Programming Studio: Defining new search patterns">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-table.html#Index-table" rel="index" title="Index table">
<link href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files" rel="up" title="Customizing through XML and Python files">
<link href="Adding-support-for-new-languages.html#Adding-support-for-new-languages" rel="next" title="Adding support for new languages">
<link href="Creating-themes.html#Creating-themes" rel="previous" title="Creating themes">
<style type="text/css">
<!--
   

a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
pre.smallexample {background-color:rgb(240,240,240);
                     font-family: courier new,courier,fixed;
                     font-size: 14px;
                     margin: 0px 40px 0px 40px;
                     border-width: 1px 2px 2px 1px;
                     border-top-style: dotted;
                     border-left-style: dotted;
                     border-right-style: solid;
                     border-bottom-style: solid;
                     border-color: black;}
   code             {color:black;
                     font-family: courier new,courier,fixed;
                     font-size: 14px;}
   body             {font-family: arial,helvetica,sans-serif;
                     font-size: 16px;
                     max-width: 800px;
                     text-align: justify}
   samp             {font-family: courier new,courier,fixed;
                     font-size: 14px}
                    

-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Defining-new-search-patterns"></a>
<div class="header">
<p>
Next: <a href="Adding-support-for-new-languages.html#Adding-support-for-new-languages" accesskey="n" rel="next">Adding support for new languages</a>, Previous: <a href="Creating-themes.html#Creating-themes" accesskey="p" rel="previous">Creating themes</a>, Up: <a href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files" accesskey="u" rel="up">Customizing through XML and Python files</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Defining-new-search-patterns-1"></a>
<h4 class="subsection">16.5.11 Defining new search patterns</h4>
<a name="index-_003cvsearch_002dpattern_003e"></a>
<a name="index-predefined-patterns"></a>

<p>The search dialog contains a number of predefined search patterns for Ada, C
and C++. These are generally complex regular expressions, presented in the
dialog with a more descriptive name. This includes for instance
&quot;Ada assignment&quot;, which will match all such assignments.
</p>
<p>You can define your own search patterns in the customization files. This is
done through the <code>&lt;vsearch-pattern&gt;</code> tag. This tag can have a number of
children tags:
</p>
<dl compact="compact">
<dt><code>&lt;name&gt;</code></dt>
<dd>
<p>This tag is the string that is displayed in the search dialog to
represent the new pattern. This is the text that the user will
effectively see, instead of the often hard to understand regular
expression.
</p>
</dd>
<dt><code>&lt;regexp&gt;</code></dt>
<dd>
<p>This tag provides the regular expression to use when the pattern has
been selected by the user. Be careful that you must protect reserved
XML characters such as &rsquo;&lt;&rsquo; and replace them by their equivalent
expansion (&quot;&amp;lt;&quot; for this character).
</p>
<p>This accepts one optional attribute, named <code>case-sensitive</code>. This
attribute accepts one of two possible values (&quot;true&quot; or &quot;false&quot;) which
indicates whether the search should distinguish lower case and upper
case letters. Its default value is &quot;false&quot;.
</p>
</dd>
<dt><code>&lt;string&gt;</code></dt>
<dd>
<p>This tag provides a constant string that should be searched.
Only one of <code>&lt;regexp&gt;</code> and <code>&lt;string&gt;</code> should be provided. If
both exists, the first <code>&lt;regexp&gt;</code> child found is used. If there is
none, the first <code>&lt;string&gt;</code> child is used.
</p>
<p>The tag accepts the same optional attribute <code>case-sensitive</code> as
above
</p></dd>
</dl>

<p>Here is a small example on how the &quot;Ada assignment&quot; pattern was
defined.
</p>
<div class="smallexample">
<pre class="smallexample">&lt;?xml version=&quot;1.0&quot; ?&gt;
&lt;search&gt;
  &lt;vsearch-pattern&gt;
    &lt;name&gt;Ada: assignment&lt;/name&gt;
    &lt;regexp case-sensitive=&quot;false&quot;&gt;\b(\w+)\s*:=&lt;/regexp&gt;
  &lt;/vsearch-pattern&gt;
&lt;/search&gt;
</pre></div>

<hr>
<div class="header">
<p>
Next: <a href="Adding-support-for-new-languages.html#Adding-support-for-new-languages" accesskey="n" rel="next">Adding support for new languages</a>, Previous: <a href="Creating-themes.html#Creating-themes" accesskey="p" rel="previous">Creating themes</a>, Up: <a href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files" accesskey="u" rel="up">Customizing through XML and Python files</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>