gnat-gps-doc 5.0-6 / usr / share / doc / gnat-gps / html / The-GPS-Shell.html

This file is indexed.

/usr/share/doc/gnat-gps/html/The-GPS-Shell.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
<html lang="en">
<head>
<title>The GPS Shell - 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="Scripting-GPS.html#Scripting-GPS" title="Scripting GPS">
<link rel="prev" href="Scripts-and-GPS-actions.html#Scripts-and-GPS-actions" title="Scripts and GPS actions">
<link rel="next" href="The-Python-Interpreter.html#The-Python-Interpreter" title="The Python Interpreter">
<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-GPS-Shell"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="The-Python-Interpreter.html#The-Python-Interpreter">The Python Interpreter</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Scripts-and-GPS-actions.html#Scripts-and-GPS-actions">Scripts and GPS actions</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Scripting-GPS.html#Scripting-GPS">Scripting GPS</a>
<hr>
</div>

<h4 class="subsection">16.8.3 The GPS Shell</h4>

<p><a name="index-gps-shell-893"></a><!--  -->

<p class="noindent">The GPS shell is a very simple-minded, line-oriented language. It is
accessible through the <code>Shell</code> window at the bottom of the GPS
window. It is similar to a Unix shell, or a command window on Windows
systems.

   <p>Type <code>help</code> at the prompt to get the list of available commands,
or <code>help</code> followed by the name of a command to get more
information on that specific command.

   <p>The following example shows how to get some information on a source
entity, and find all references to this entity in the application. It
searches for the entity "entity_name", which has at least one
reference anywhere in the file "file_name.adb". After the first
command, GPS returns an identifier for this entity, which can be used
for all commands that need an entity as a parameter, as is the case
for the second command. When run, the second command will
automatically display all matching references in the location window.

<pre class="smallexample">     GPS&gt; Entity my_entity file_name.adb
     &lt;Entity_0x09055790&gt;
     GPS&gt; Entity.find_all_refs &lt;Entity_0x09055790&gt;
</pre>
   <p>Since the GPS shell is very simple, it doesn't provide any reference
counting for the result types. As a result, all the values returned by
a command, such as <code>&lt;Entity_0x09055790&gt;</code> in the example above,
are kept in memory.

   <p><a name="index-clear_005fcache-command-894"></a>The GPS shell provides the command <code>clear_cache</code> which removes
all such values from the memory. After this command is run, you can no
longer use references obtained from previous commands, although of
course you can run these commands again to get a new reference.

   <p>The return value of the 9 previous commands can easily be recalled by
passing <code>%1</code>, <code>%2</code>, <small class="dots">...</small> on the command line. For instance,
the previous example could be rewritten as

<pre class="smallexample">     GPS&gt; Entity my_entity file_name.adb
     &lt;Entity_0x09055790&gt;
     GPS&gt; Entity.find_all_refs %1
</pre>
   <p>These return values will be modified also for internal commands sent
by GPS, so you should really only use this when you emit multiple
commands at the same time, and don't do any other action in GPS. This
is mostly useful when used for command-line scripts (see <code>--eval</code>
and <code>--load</code>), or for custom files, See <a href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files">Customizing through XML and Python files</a>.

   <p>Arguments to commands can, but need not, be quoted. If they don't contain
any space, double-quote ('"') or newline characters, you do not need to quote
them. Otherwise, you should surround them with double-quotes, and protect
any double-quote part of the argument by preceding it with a backslash.

   <p>There is another way to quote a command: use three double-quotes characters in
a row. Any character loses its special meaning until the next three
double-quotes characters set. This is useful if you do not know in advance
the contents of the string you are quoting.

<pre class="smallexample">     Locations.parse """%1 """ category_name
</pre>
   </body></html>

APT Browse - Built by Thomas Orozco.