This file is indexed.

/usr/share/doc/gnat-gps/html/Reloading-a-python-file-in-GPS.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
<html lang="en">
<head>
<title>Reloading a python file in GPS - 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="Python-FAQ.html#Python-FAQ" title="Python FAQ">
<link rel="prev" href="Redirecting-the-output-to-specific-windows.html#Redirecting-the-output-to-specific-windows" title="Redirecting the output to specific windows">
<link rel="next" href="Printing-the-GPS-Python-documentation.html#Printing-the-GPS-Python-documentation" title="Printing the GPS Python documentation">
<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="Reloading-a-python-file-in-GPS"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Printing-the-GPS-Python-documentation.html#Printing-the-GPS-Python-documentation">Printing the GPS Python documentation</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Redirecting-the-output-to-specific-windows.html#Redirecting-the-output-to-specific-windows">Redirecting the output to specific windows</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Python-FAQ.html#Python-FAQ">Python FAQ</a>
<hr>
</div>

<h5 class="subsubsection">16.8.7.6 Reloading a python file in GPS</h5>

<p>After you have made modification to a python file, you might want to
reload it in GPS. This requires careful use of python commands.

   <p>Here is an example. Lets assume you have a python file (<samp><span class="file">"mymod.py"</span></samp>)
which contains the following:

<pre class="smallexample">     GPS.parse_xml ("""
        &lt;action name="my_action"&gt;
           &lt;shell lang="python"&gt;mymod.myfunc()&lt;/shell&gt;
        &lt;/action&gt;""")
     
     def myfunc():
        print "In myfunc\n"
</pre>
   <p>As you can guess from this file, it defines an action "my_action", that you
can for instance associate with a keybinding through the Edit-&gt;Key shortcuts
menu.

   <p>If this file has been copied in one of the <samp><span class="file">plug-ins</span></samp> directories,
it will be automatically loaded at startup.

   <p>Notice that the function <code>myfunc</code> is thus found in a separate namespace,
with the name <code>mymod</code>, same as the file.

   <p>If you decide, during your GPS session, to edit this file and have the
function print "In myfunc2" instead, you then have to reload the file by
typing the following command in the Python console:

<pre class="smallexample">     &gt; execfile ("HOME/.gps/plug-ins/mymod.py", mymod.__dict__)
</pre>
   <p>The first parameter is the full path to the file that you want to reload. 
The second argument is less obvious, but indicates that the file should be
reloaded in the namespace <code>mymod</code>.

   <p>If you omit the optional second parameter, Python will load the file, but
the function <code>myfunc</code> will be defined in the global namespace, and thus
the new definition is accessible through

<pre class="smallexample">     &gt; myfunc()
</pre>
   <p>Thus, the key shortcut you had set, which still executes <code>mymod.myfunc()</code>
will keep executing the old definition.

   <p>By default, GPS provides a contextual menu when you are editing a Python
file. This contextual menu (Python-&gt;Reload module) will take care of all
the above details.

<!--  -->
   </body></html>