This file is indexed.

/usr/share/doc/gnat-gps/html/Visual-Comparison.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
<html lang="en">
<head>
<title>Visual Comparison - 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="Tools.html#Tools" title="Tools">
<link rel="prev" href="Coding-Standard.html#Coding-Standard" title="Coding Standard">
<link rel="next" href="Code-Fixing.html#Code-Fixing" title="Code Fixing">
<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="Visual-Comparison"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Code-Fixing.html#Code-Fixing">Code Fixing</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Coding-Standard.html#Coding-Standard">Coding Standard</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Tools.html#Tools">Tools</a>
<hr>
</div>

<h3 class="section">13.3 Visual Comparison</h3>

<p><a name="index-visual-diff-616"></a>The visual comparison, available either from the VCS menus or from the Tools
menu, provide a way to display graphically differences between two or three
files, or two different versions of the same file.

   <p>The 2-file comparison tool is based on the standard text command
<samp><span class="command">diff</span></samp>, available on all Unix systems. Under Windows, a default
implementation is provided with GPS, called <samp><span class="command">gnudiff.exe</span></samp>. 
You may want to provide an alternate implementation by e.g. installing a
set of Unix tools such as cygwin (<a href="http://www.cygwin.com">http://www.cygwin.com</a>).

   <p>The 3-file comparison tool is based on the text command <samp><span class="command">diff3</span></samp>,
available on all Unix systems. Under Windows, this tool is not shipped
with GPS. It is available as part of cygwin, for example.

   <p>When querying a visual comparison in GPS, in Side_By_Side mode, the user area
will show, side by side, editors for the files involved in the comparison. 
The reference file is placed by default on the left side. When in Unified mode,
GPS will not open a new editor, but will show all the changes directly in the
original editor. Note that Unified mode is relevant only when comparing two
files: when comparing three files, the Side_By_Side mode is used.

   <p>Color highlighting will be added to the file editors:

     <dl>
<dt><b>gray</b><dd>This color is used for all the chunks on the reference (left) file. Only
the modified (right) file is displayed with different colors.

     <br><dt><b>yellow</b><dd>This color is used to display lines that have been modified compared to the
reference file. When there are fine differences within one line, they are
shown in a brighter yellow.

     <br><dt><b>green</b><dd>Used to display lines added compared to the reference file; in other words,
lines that are not present in the reference file.

     <br><dt><b>red</b><dd>Used to display lines removed from the reference file; in other words,
lines that are present only in the reference file.

   </dl>

   <p>These colors can be configured, see <a href="The-Preferences-Dialog.html#The-Preferences-Dialog">The Preferences Dialog</a>.

   <p>As with all highlighted lines in GPS, the visual differences highlights are
visible in the Speed Column at the left of the editors.

   <p>Blank lines are also added in the editors, in places that correspond to
existing lines in the other editors. The vertical and horizontal scrolling
are synchronized between all editors involved in a visual comparison.

   <p>When a visual comparison is created, the Locations View is populated with the
entries for each chunk of differences, and can be used to navigate between
those.

   <p>Closing one of the editors involved in a visual comparison removes the
highlighting, blank lines, and scrolling in the other editors.

   <p>Editors involved in a visual comparison have a contextual menu
<code>Visual diff</code> that contains the following entries:

     <dl>
<dt><code>Recompute</code><dd>Regenerates the visual comparison. This is useful, for example, when one of
the editors has been modified by hand while it was involved in a visual
comparison

     <br><dt><code>Hide</code><dd>Removes the highlighting corresponding to the visual comparison from all
editors involved

     <br><dt><code>Close editors</code><dd>Closes all editors involved in this visual comparison

     <br><dt><code>Use this editor as reference</code><dd>Change the reference to this editor. (This is only visible when displaying a
visual comparison involving 3 files).

   </dl>

   <p><a name="index-screen-shot-617"></a><img src="visual-diff.jpg" alt="visual-diff.jpg">

   </body></html>