This file is indexed.

/usr/share/gap/doc/ref/chap77.html is in gap-doc 4r7p5-2.

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
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>GAP (ref) - Chapter 77: Replaced and Removed Command Names</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<meta name="generator" content="GAPDoc2HTML" />
<link rel="stylesheet" type="text/css" href="manual.css" />
<script src="manual.js" type="text/javascript"></script>
<script type="text/javascript">overwriteStyle();</script>
</head>
<body class="chap77"  onload="jscontent()">


<div class="chlinktop"><span class="chlink1">Goto Chapter: </span><a href="chap0.html">Top</a>  <a href="chap1.html">1</a>  <a href="chap2.html">2</a>  <a href="chap3.html">3</a>  <a href="chap4.html">4</a>  <a href="chap5.html">5</a>  <a href="chap6.html">6</a>  <a href="chap7.html">7</a>  <a href="chap8.html">8</a>  <a href="chap9.html">9</a>  <a href="chap10.html">10</a>  <a href="chap11.html">11</a>  <a href="chap12.html">12</a>  <a href="chap13.html">13</a>  <a href="chap14.html">14</a>  <a href="chap15.html">15</a>  <a href="chap16.html">16</a>  <a href="chap17.html">17</a>  <a href="chap18.html">18</a>  <a href="chap19.html">19</a>  <a href="chap20.html">20</a>  <a href="chap21.html">21</a>  <a href="chap22.html">22</a>  <a href="chap23.html">23</a>  <a href="chap24.html">24</a>  <a href="chap25.html">25</a>  <a href="chap26.html">26</a>  <a href="chap27.html">27</a>  <a href="chap28.html">28</a>  <a href="chap29.html">29</a>  <a href="chap30.html">30</a>  <a href="chap31.html">31</a>  <a href="chap32.html">32</a>  <a href="chap33.html">33</a>  <a href="chap34.html">34</a>  <a href="chap35.html">35</a>  <a href="chap36.html">36</a>  <a href="chap37.html">37</a>  <a href="chap38.html">38</a>  <a href="chap39.html">39</a>  <a href="chap40.html">40</a>  <a href="chap41.html">41</a>  <a href="chap42.html">42</a>  <a href="chap43.html">43</a>  <a href="chap44.html">44</a>  <a href="chap45.html">45</a>  <a href="chap46.html">46</a>  <a href="chap47.html">47</a>  <a href="chap48.html">48</a>  <a href="chap49.html">49</a>  <a href="chap50.html">50</a>  <a href="chap51.html">51</a>  <a href="chap52.html">52</a>  <a href="chap53.html">53</a>  <a href="chap54.html">54</a>  <a href="chap55.html">55</a>  <a href="chap56.html">56</a>  <a href="chap57.html">57</a>  <a href="chap58.html">58</a>  <a href="chap59.html">59</a>  <a href="chap60.html">60</a>  <a href="chap61.html">61</a>  <a href="chap62.html">62</a>  <a href="chap63.html">63</a>  <a href="chap64.html">64</a>  <a href="chap65.html">65</a>  <a href="chap66.html">66</a>  <a href="chap67.html">67</a>  <a href="chap68.html">68</a>  <a href="chap69.html">69</a>  <a href="chap70.html">70</a>  <a href="chap71.html">71</a>  <a href="chap72.html">72</a>  <a href="chap73.html">73</a>  <a href="chap74.html">74</a>  <a href="chap75.html">75</a>  <a href="chap76.html">76</a>  <a href="chap77.html">77</a>  <a href="chap78.html">78</a>  <a href="chap79.html">79</a>  <a href="chap80.html">80</a>  <a href="chap81.html">81</a>  <a href="chap82.html">82</a>  <a href="chap83.html">83</a>  <a href="chap84.html">84</a>  <a href="chap85.html">85</a>  <a href="chap86.html">86</a>  <a href="chap87.html">87</a>  <a href="chapBib.html">Bib</a>  <a href="chapInd.html">Ind</a>  </div>

<div class="chlinkprevnexttop">&nbsp;<a href="chap0.html">[Top of Book]</a>&nbsp;  <a href="chap0.html#contents">[Contents]</a>&nbsp;  &nbsp;<a href="chap76.html">[Previous Chapter]</a>&nbsp;  &nbsp;<a href="chap78.html">[Next Chapter]</a>&nbsp;  </div>

<p id="mathjaxlink" class="pcenter"><a href="chap77_mj.html">[MathJax on]</a></p>
<p><a id="X78C85ED17F00DCC1" name="X78C85ED17F00DCC1"></a></p>
<div class="ChapSects"><a href="chap77.html#X78C85ED17F00DCC1">77 <span class="Heading">Replaced and Removed Command Names</span></a>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap77.html#X7AA51AC9870D2360">77.1 <span class="Heading">Group Actions – Name Changes</span></a>
</span>
</div>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap77.html#X831734077B00CB3B">77.2 <span class="Heading">Package Interface – Obsolete Functions and Name Changes</span></a>
</span>
</div>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap77.html#X79676CD27EF0F096">77.3 <span class="Heading">Normal Forms of Integer Matrices – Name Changes</span></a>
</span>
</div>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap77.html#X7F6A6CBC7C9E91E5">77.4 <span class="Heading">Miscellaneous Name Changes or Removed Names</span></a>
</span>
<div class="ContSSBlock">
<span class="ContSS"><br /><span class="nocss">&nbsp;&nbsp;</span><a href="chap77.html#X87348614848EAD64">77.4-1 InfoObsolete</a></span>
</div></div>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap77.html#X7F2FF72A7AD60E0C">77.5 <span class="Heading">The former .gaprc file</span></a>
</span>
</div>
</div>

<h3>77 <span class="Heading">Replaced and Removed Command Names</span></h3>

<p>In general we try to keep <strong class="pkg">GAP</strong> 4 compatible with former releases as much as possible. Nevertheless, from time to time it seems appropriate to remove some commands or to change the names of some commands or variables. There are various reasons for that: Some functionality was improved and got another (hopefully better) interface, names turned out to be too special or too general for the underlying functionality, or names are found to be unintuitive or inconsistent with other names.</p>

<p>In this chapter we collect such old names while pointing to the sections which explain how to substitute them. Usually, old names will be available for several releases; they may be removed when they don't seem to be used any more.</p>

<p>The obsolete <strong class="pkg">GAP</strong> code is collected in two library files, <code class="file">lib/obsolete.gd</code> and <code class="file">lib/obsolete.gi</code>. By default, these files are read when <strong class="pkg">GAP</strong> is started. It may be useful to omit reading these files, for example in order to make sure that one's own <strong class="pkg">GAP</strong> code does not rely on the obsolete variables. For that, one can use the <code class="code">-O</code> command line option (see <a href="chap3.html#X782751D5858A6EAF"><span class="RefLink">3.1</span></a>) or set the component <code class="code">ReadObsolete</code> in the file <code class="file">gap.ini</code> to <code class="keyw">false</code> (see <a href="chap3.html#X7FD66F977A3B02DF"><span class="RefLink">3.2</span></a>). Note that <code class="code">-O</code> command line option overrides <code class="code">ReadObsolete</code>.</p>

<p>(Note that the condition whether the library files with the obsolete <strong class="pkg">GAP</strong> code shall be read has changed. In <strong class="pkg">GAP</strong> 4.3 and 4.4, the global variables <code class="code">GAP_OBSOLESCENT</code> and <code class="code">GAPInfo.ReadObsolete</code> –to be set in the user's <code class="file">.gaprc</code> file– were used to control this behaviour.)</p>

<p><a id="X7AA51AC9870D2360" name="X7AA51AC9870D2360"></a></p>

<h4>77.1 <span class="Heading">Group Actions – Name Changes</span></h4>

<p>The concept of a group action is sometimes referred to as a "group operation". In <strong class="pkg">GAP</strong> 3 as well as in older versions of <strong class="pkg">GAP</strong> 4 the term <code class="code">Operation</code> was used instead of <code class="code">Action</code>. We decided to change the names to avoid confusion with the term "operation" as in <code class="func">DeclareOperation</code> (<a href="chap79.html#X843F48137B899BC3"><span class="RefLink">79.18-6</span></a>) and "operations for Xyz".</p>

<p>Here are some examples of such name changes.</p>

<div class="pcenter"><table class="GAPDocTable">
<tr>
<td class="tdleft"><em>OLD</em></td>
<td class="tdleft"><em>NOW USE</em></td>
</tr>
<tr>
<td class="tdleft"><code class="code">Operation</code></td>
<td class="tdleft"><code class="func">Action</code> (<a href="chap41.html#X85A8E93D786C3C9C"><span class="RefLink">41.7-2</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">RepresentativeOperation</code></td>
<td class="tdleft"><code class="func">RepresentativeAction</code> (<a href="chap41.html#X857DC7B085EB0539"><span class="RefLink">41.6-1</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">OperationHomomorphism</code></td>
<td class="tdleft"><code class="func">ActionHomomorphism</code> (<a href="chap41.html#X78E6A002835288A4"><span class="RefLink">41.7-1</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">FunctionOperation</code></td>
<td class="tdleft"><code class="func">FunctionAction</code> (<a href="chap41.html#X86153CB087394DC1"><span class="RefLink">41.12-4</span></a>)</td>
</tr>
</table><br /><p>&nbsp;</p><br />
</div>

<p><a id="X831734077B00CB3B" name="X831734077B00CB3B"></a></p>

<h4>77.2 <span class="Heading">Package Interface – Obsolete Functions and Name Changes</span></h4>

<p>With <strong class="pkg">GAP</strong> 4.4 the package interface was changed. Thereby some functions became obsolete and the names of some others were made more consistent.</p>

<p>The following functions are no longer needed: <code class="code">DeclarePackage</code>, <code class="code">DeclareAutoPackage</code>, <code class="code">DeclarePackageDocumentation</code> and <code class="code">DeclarePackageAutoDocumentation</code>. They are substituted by entries in the packages' <code class="file">PackageInfo.g</code> files, see <a href="chap76.html#X85C8DE357EE424D8"><span class="RefLink">76.3-11</span></a>.</p>

<p>Furthermore, the global variable <code class="code">PACKAGES_VERSIONS</code> is no longer needed, since this information is now contained in the <code class="code">GAPInfo.PackagesInfo</code> record (see <a href="chap3.html#X8354754E7935F935"><span class="RefLink">3.5-1</span></a>). The global variable <code class="code">Revisions</code> is also no longer needed, since the function <code class="code">DisplayRevision</code> was made obsolete in <strong class="pkg">GAP</strong> 4.5.</p>

<p>The following function names were changed.</p>

<div class="pcenter"><table class="GAPDocTable">
<tr>
<td class="tdleft"><em>OLD</em></td>
<td class="tdleft"><em>NOW USE</em></td>
</tr>
<tr>
<td class="tdleft"><code class="code">RequirePackage</code></td>
<td class="tdleft"><code class="func">LoadPackage</code> (<a href="chap76.html#X79B373A77B29D1F5"><span class="RefLink">76.2-1</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">ReadPkg</code></td>
<td class="tdleft"><code class="func">ReadPackage</code> (<a href="chap76.html#X870954577B27DCAB"><span class="RefLink">76.3-1</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">RereadPkg</code></td>
<td class="tdleft"><code class="func">RereadPackage</code> (<a href="chap76.html#X870954577B27DCAB"><span class="RefLink">76.3-1</span></a>)</td>
</tr>
</table><br /><p>&nbsp;</p><br />
</div>

<p><a id="X79676CD27EF0F096" name="X79676CD27EF0F096"></a></p>

<h4>77.3 <span class="Heading">Normal Forms of Integer Matrices – Name Changes</span></h4>

<p>Former versions of <strong class="pkg">GAP</strong> 4 documented several functions for computing the Smith or Hermite normal form of integer matrices. Some of them were never implemented and it was unclear which commands to use. The functionality of all of these commands is now available with <code class="func">NormalFormIntMat</code> (<a href="chap25.html#X81FB746E82BE6CDA"><span class="RefLink">25.2-9</span></a>) and a few interface functions.</p>

<p><a id="X7F6A6CBC7C9E91E5" name="X7F6A6CBC7C9E91E5"></a></p>

<h4>77.4 <span class="Heading">Miscellaneous Name Changes or Removed Names</span></h4>

<p>In former releases of <strong class="pkg">GAP</strong> 4 there were some global variable names bound to general information about the running <strong class="pkg">GAP</strong>, such as path names or command line options. Although they were not officially documented they were used by several users and in some packages. We mention here <code class="code">BANNER</code> and <code class="code">QUIET</code>. This type of information is now collected in the global record <code class="func">GAPInfo</code> (<a href="chap3.html#X8354754E7935F935"><span class="RefLink">3.5-1</span></a>).</p>

<p>Here are some further name changes.</p>

<div class="pcenter"><table class="GAPDocTable">
<tr>
<td class="tdleft"><em>OLD</em></td>
<td class="tdleft"><em>NOW USE</em></td>
</tr>
<tr>
<td class="tdleft"><code class="code">MonomialTotalDegreeLess</code></td>
<td class="tdleft"><code class="func">MonomialExtGrlexLess</code> (<a href="chap66.html#X7A30E10B820311D1"><span class="RefLink">66.17-14</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">NormedVectors</code></td>
<td class="tdleft"><code class="func">NormedRowVectors</code> (<a href="chap61.html#X7D6537F87E940344"><span class="RefLink">61.9-11</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">MutableIdentityMat</code></td>
<td class="tdleft"><code class="func">IdentityMat</code> (<a href="chap24.html#X7DB902CE848D1524"><span class="RefLink">24.5-1</span></a>)</td>
</tr>
<tr>
<td class="tdleft"><code class="code">MutableNullMat</code></td>
<td class="tdleft"><code class="func">NullMat</code> (<a href="chap24.html#X86D343A77D9B3D4D"><span class="RefLink">24.5-2</span></a>)</td>
</tr>
</table><br /><p>&nbsp;</p><br />
</div>

<p><a id="X87348614848EAD64" name="X87348614848EAD64"></a></p>

<h5>77.4-1 InfoObsolete</h5>

<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">&#8227; InfoObsolete</code></td><td class="tdright">( global variable )</td></tr></table></div>
<p>is an info class to display warnings when an obsolete variable is used. By default, these warnings are switched off since the info level for this class is 0. Setting it to 1 will trigger warnings if <strong class="pkg">GAP</strong> will detect that an obsolete variable is used at runtime (this detection is possible, however, only for obsolete variables declared using <code class="code">DeclareObsoleteSynonym</code>).</p>

<p>To check that the <strong class="pkg">GAP</strong> code does not use obsolete variables at the parsing time, and not at a runtime, use <code class="code">-O</code> command line option, see <a href="chap3.html#X782751D5858A6EAF"><span class="RefLink">3.1</span></a>.</p>

<p><a id="X7F2FF72A7AD60E0C" name="X7F2FF72A7AD60E0C"></a></p>

<h4>77.5 <span class="Heading">The former .gaprc file</span></h4>

<p>Up to <strong class="pkg">GAP</strong> 4.4, a file <code class="file">.gaprc</code> in the user's home directory (if available, and <strong class="pkg">GAP</strong> was started without <code class="code">-r</code> option) was read automatically during startup, early enough for influencing the autoloading of packages and late enough for being allowed to execute any <strong class="pkg">GAP</strong> code. On Windows machines this file was called <code class="file">gap.rc</code>.</p>

<p>In <strong class="pkg">GAP</strong> 4.5 the startup mechanism has changed, see <a href="chap3.html#X7FD66F977A3B02DF"><span class="RefLink">3.2</span></a> for details. These new configuration files are now contained in a directory <code class="code">GAPInfo.UserGapRoot</code>.</p>

<p>For the sake of partial backwards compatibility, also the former file <code class="file">~/.gaprc</code> is still supported for such initializations, but this file is read only if the directory <code class="code">GAPInfo.UserGapRoot</code> does not exist. In that case the <code class="file">~/.gaprc</code> is read at the same time as <code class="file">gaprc</code> would be read, i. e., too late for influencing the startup of <strong class="pkg">GAP</strong>.</p>

<p>As before, the command line option <code class="code">-r</code> disables reading <code class="file">~/.gaprc</code>, see <a href="chap3.html#X782751D5858A6EAF"><span class="RefLink">3.1</span></a>.</p>

<p>To migrate from the old setup to the new one introduced with <strong class="pkg">GAP</strong> 4.5, first have a look at the function <code class="func">WriteGapIniFile</code> (<a href="chap3.html#X7B0AD104839B6C3C"><span class="RefLink">3.2-3</span></a>). Many users will find that all or most of what was set in the old <code class="file">~/.gaprc</code> file can now be done via the user preferences in a <code class="file">gap.ini</code> file. If you had code for new functions or abbreviations in your old <code class="file">~/.gaprc</code> file or you were reading additional files, then move this into the file <code class="file">gaprc</code> (without the leading dot, same name for all operating systems) in the directory <code class="code">GAPInfo.UserGapRoot</code>.</p>


<div class="chlinkprevnextbot">&nbsp;<a href="chap0.html">[Top of Book]</a>&nbsp;  <a href="chap0.html#contents">[Contents]</a>&nbsp;  &nbsp;<a href="chap76.html">[Previous Chapter]</a>&nbsp;  &nbsp;<a href="chap78.html">[Next Chapter]</a>&nbsp;  </div>


<div class="chlinkbot"><span class="chlink1">Goto Chapter: </span><a href="chap0.html">Top</a>  <a href="chap1.html">1</a>  <a href="chap2.html">2</a>  <a href="chap3.html">3</a>  <a href="chap4.html">4</a>  <a href="chap5.html">5</a>  <a href="chap6.html">6</a>  <a href="chap7.html">7</a>  <a href="chap8.html">8</a>  <a href="chap9.html">9</a>  <a href="chap10.html">10</a>  <a href="chap11.html">11</a>  <a href="chap12.html">12</a>  <a href="chap13.html">13</a>  <a href="chap14.html">14</a>  <a href="chap15.html">15</a>  <a href="chap16.html">16</a>  <a href="chap17.html">17</a>  <a href="chap18.html">18</a>  <a href="chap19.html">19</a>  <a href="chap20.html">20</a>  <a href="chap21.html">21</a>  <a href="chap22.html">22</a>  <a href="chap23.html">23</a>  <a href="chap24.html">24</a>  <a href="chap25.html">25</a>  <a href="chap26.html">26</a>  <a href="chap27.html">27</a>  <a href="chap28.html">28</a>  <a href="chap29.html">29</a>  <a href="chap30.html">30</a>  <a href="chap31.html">31</a>  <a href="chap32.html">32</a>  <a href="chap33.html">33</a>  <a href="chap34.html">34</a>  <a href="chap35.html">35</a>  <a href="chap36.html">36</a>  <a href="chap37.html">37</a>  <a href="chap38.html">38</a>  <a href="chap39.html">39</a>  <a href="chap40.html">40</a>  <a href="chap41.html">41</a>  <a href="chap42.html">42</a>  <a href="chap43.html">43</a>  <a href="chap44.html">44</a>  <a href="chap45.html">45</a>  <a href="chap46.html">46</a>  <a href="chap47.html">47</a>  <a href="chap48.html">48</a>  <a href="chap49.html">49</a>  <a href="chap50.html">50</a>  <a href="chap51.html">51</a>  <a href="chap52.html">52</a>  <a href="chap53.html">53</a>  <a href="chap54.html">54</a>  <a href="chap55.html">55</a>  <a href="chap56.html">56</a>  <a href="chap57.html">57</a>  <a href="chap58.html">58</a>  <a href="chap59.html">59</a>  <a href="chap60.html">60</a>  <a href="chap61.html">61</a>  <a href="chap62.html">62</a>  <a href="chap63.html">63</a>  <a href="chap64.html">64</a>  <a href="chap65.html">65</a>  <a href="chap66.html">66</a>  <a href="chap67.html">67</a>  <a href="chap68.html">68</a>  <a href="chap69.html">69</a>  <a href="chap70.html">70</a>  <a href="chap71.html">71</a>  <a href="chap72.html">72</a>  <a href="chap73.html">73</a>  <a href="chap74.html">74</a>  <a href="chap75.html">75</a>  <a href="chap76.html">76</a>  <a href="chap77.html">77</a>  <a href="chap78.html">78</a>  <a href="chap79.html">79</a>  <a href="chap80.html">80</a>  <a href="chap81.html">81</a>  <a href="chap82.html">82</a>  <a href="chap83.html">83</a>  <a href="chap84.html">84</a>  <a href="chap85.html">85</a>  <a href="chap86.html">86</a>  <a href="chap87.html">87</a>  <a href="chapBib.html">Bib</a>  <a href="chapInd.html">Ind</a>  </div>

<hr />
<p class="foot">generated by <a href="http://www.math.rwth-aachen.de/~Frank.Luebeck/GAPDoc">GAPDoc2HTML</a></p>
</body>
</html>