This file is indexed.

/usr/share/doc/gnat-gps/html/The-Version-Control-Contextual-Menu.html is in gnat-gps-doc 5.0-6.

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
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
<html lang="en">
<head>
<title>The Version Control Contextual Menu - Using the GNAT Programming Studio</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNAT Programming Studio">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Version-Control-System.html#Version-Control-System" title="Version Control System">
<link rel="prev" href="The-VCS-Menu.html#The-VCS-Menu" title="The VCS Menu">
<link rel="next" href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file" title="Working with global ChangeLog file">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
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 3 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/'.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
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>
<div class="node">
<a name="The-Version-Control-Contextual-Menu"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file">Working with global ChangeLog file</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="The-VCS-Menu.html#The-VCS-Menu">The VCS Menu</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Version-Control-System.html#Version-Control-System">Version Control System</a>
<hr>
</div>

<h3 class="section">12.4 The Version Control Contextual Menu</h3>

<p class="noindent">This section describes the version control contextual menu displayed when you
right-click on an entity (e.g. a file, a directory, a project) from various
parts of GPS, including the project view, the source editor and the VCS
Explorer.

   <p>Depending on the context, some of the items described in this section won't
be shown, which means that they are not relevant to the current context.

     <dl>
<dt><b>Remove project</b><dd>Only displayed on a project line. This will remove the selected
project from the VCS Explorer.

     <br><dt><b>Expand all</b><dd>Expand all VCS Explorer project nodes.

     <br><dt><b>Collapse all</b><dd>Collapse all VCS Explorer project nodes.

     <br><dt><b>Clear View</b><dd>Clear the VCS Explorer.

     <br><dt><b>Query status</b><dd>Query the status of the selected item. Brings up the VCS Explorer.

     <br><dt><b>Update</b><dd><a name="Update"></a>Update the currently selected item (file, directory or project).

     <br><dt><b>Commit</b><dd><a name="Commit"></a>Submits the changes made to the file to the repository, and queries
the status for the file once the change is made.

     <p>It is possible to tell GPS to check the file before the actual commit
happens. This is done by specifying a <code>File checker</code> in the
<code>VCS</code> tab of the project properties dialog. This <code>File
checker</code> is in fact a script or executable that takes an absolute file
name as argument, and displays any error message on the standard
output. The VCS commit operation will actually occur only if nothing
was written on the standard output.

     <p>It is also possible to check the change-log of a file before commit, by
specifying a <code>Log checker</code> in the project properties dialog. This
works on change-log files in the same way as the <code>File checker</code> works on
source files.

     <br><dt><b>Open</b><dd><a name="Open"></a>Open the currently selected file for writing. On some VCS systems,
this is a necessary operation, and on other systems it is not.

     <br><dt><b>View entire revision history</b><dd><a name="View-revision-history"></a>Show the revision logs for all previous revisions of this file.

     <br><dt><b>View specific revision history</b><dd>Show the revision logs for one previous revision of this file.

     <br><dt><b>Compare against head revision</b><dd><a name="index-compare-598"></a><a name="Compare-against-head"></a>Show a visual comparison between the local file and the most recent
version of that file in the repository.

     <br><dt><b>Compare against other revision</b><dd><a name="Compare-against-working"></a>Show a visual comparison between the local file and one specific
version of that file in the repository.

     <br><dt><b>Compare two revisions</b><dd><a name="Compare-against-revision"></a>Show a visual comparison between two specific revisions
of the file in the repository.

     <br><dt><b>Compare base against head</b><dd><a name="Compare-base-against-head"></a>Show a visual comparison between the corresponding version of the
file in the repository and the most recent version of that file.

     <br><dt><b>Compare against tag/branch</b><dd><a name="Compare-base-against-tag_002fbranch"></a>Only available on a Revision View and over a tag/branch. Show a visual
comparison between the corresponding version of the file in the
repository and the version of that file in the tag/branch.

     <br><dt><b>Annotate</b><dd><a name="Annotate"></a>Display the annotations for the file, i.e. the information for each
line of the file showing the revision corresponding to that file, and
additional information depending on the VCS system.

     <p>When using CVS or Subversion, the annotations are clickable. Left-clicking on
an annotation line will query and display the changelog associated to the
specific revision for this line.

     <br><dt><b>Remove Annotate</b><dd>Remove the annotations from the selected file.

     <br><dt><b>Edit revision log</b><dd>Edit the current revision log for the selected file.

     <br><dt><b>Edit global ChangeLog</b><dd>Edit the global ChangeLog entry for the selected file. 
see <a href="Working-with-global-ChangeLog-file.html#Working-with-global-ChangeLog-file">Working with global ChangeLog file</a>.

     <br><dt><b>Remove revision log</b><dd>Clear the current revision associated to the selected file.

     <br><dt><b>Add</b><dd>Add a file to the repository, using the current revision log for this
file. If no revision log exists, activating this menu will create
one. The file is committed in the repository.

     <br><dt><b>Add/No commit</b><dd>Add a file to the repository, using the current revision log for this
file. If no revision log exists, activating this menu will create
one. The file is not committed in the repository.

     <br><dt><b>Remove</b><dd>Remove a file from the repository, using the current revision log for
this file. If no revision log exists, activating this menu will create
one. The modification is committed in the repository.

     <br><dt><b>Remove/No commit</b><dd>Remove a file from the repository, using the current revision log for
this file. If no revision log exists, activating this menu will create
one. The modification is not committed in the repository.

     <br><dt><b>Revert</b><dd>Revert a locale file to the repository revision, discarding all local
changes.

     <br><dt><b>Resolved</b><dd>Mark files' merge conflics as resolved. Some version control systems
(like Subversion) will block any commit until this action is called.

     <br><dt><b>Switch tag/bracnh</b><dd>Only available on a Revision View and over a tag/branch name. Will
switch the tree starting from a selected root to this specific tag or
branch.

     <br><dt><b>Merge</b><dd>Only available on a Revision View and over a tag/branch name. Merge
file changes made on this specific tag/branch.

     <br><dt><b>View revision</b><dd>Only available on a Revision View and over a revision.

     <br><dt><b>Commit as new Activity</b><dd>An action to prepare a group-commit in just one-click. This action will:

          <ul>
<li>create an anonymous activity,
<li>add all files selected into the VCS Explorer into the newly
created anonymous activity,
<li>open the activity log,
</ul>

     <p>Just fill the activity log and commit the anonymous activity.

     <br><dt><b>Add to Activity</b><dd>A menu containing all the current activities. Selecting one will add
the current file to this activity. This menu is present only if the
file is not already part of an activity.

     <br><dt><b>Remove from Activity</b><dd>Remove file from the given activity. This menu is present only if the
file is already part of an activity.

     <br><dt><b>Directory</b><dd>Only available when the current context contains directory information

          <dl>
<dt><i>Add/No commit</i><dd>Add the selected directory into the VCS.

          <br><dt><i>Remove/No commit</i><dd>Remove the selected directory from the VCS.

          <br><dt><i>Commit</i><dd>Commit the selected directory into the VCS. This action is available
only if the VCS supports commit on directories, see <a href="The-VCS-node.html#The-VCS-node">The VCS node</a>.

          <br><dt><i>Add to Activity</i><dd>Add the selected directory into the VCS. This action is available
only if the VCS supports commit on directories, see <a href="The-VCS-node.html#The-VCS-node">The VCS node</a>.

          <br><dt><i>Query status for directory</i><dd>Query status for the files contained in the selected directory.

          <br><dt><i>Update directory</i><dd>Update the files in the selected directory.

          <br><dt><i>Query status for directory recursively</i><dd>Query status for the files in the selected directory and all
subdirectories recursively. Links and hidden directories are not
included.

          <br><dt><i>Update directory recursively</i><dd>Update the files in the selected directory and all
subdirectories recursively. Links and hidden directories not included..

     </dl>

     <br><dt><b>Project</b><dd>Only available when the current context contains project information

          <dl>
<dt><i>List all files in project</i><dd>Bring up the VCS Explorer with all the source files contained in the project.

          <br><dt><i>Query status for project</i><dd>Query the status for all the source files contained in the project.

          <br><dt><i>Update project</i><dd>Update all the source files in the project.

          <br><dt><i>List all files in project and sub-projects</i><dd>Bring up the VCS Explorer with all the source files contained in the
project and all imported sub-projects.

          <br><dt><i>Query status for project and sub-projects</i><dd>Query the status for all the source files contained in the project
and all imported sub-projects.

          <br><dt><i>Update project and sub-projects</i><dd>Update all the source files in the project and all imported
sub-projects.

     </dl>

     <br><dt><b>Select files same status</b><dd>Select the files having the same status as the current selected file.

     <br><dt><b>Filters</b><dd>Only available from the VCS Explorer. This menu controls filtering of the
items displayed in the list.

          <dl>
<dt><i>Show all status</i><dd>Do not filter out any file from the list in the VCS Explorer.

          <br><dt><i>Hide all status</i><dd>Filter out all the files from the list in the VCS Explorer.

          <br><dt><i>Show &lt;status&gt;</i><dd>When disabled, filter out the files with the given status from the VCS
Explorer. 
</dl>

   </dl>

   </body></html>