This file is indexed.

/usr/share/gap/doc/tut/chap1.html is in gap-doc 4r6p5-3.

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
<?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 (tut) - Chapter 1: Preface</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="chap1"  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="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="chap0.html">[Previous Chapter]</a>&nbsp;  &nbsp;<a href="chap2.html">[Next Chapter]</a>&nbsp;  </div>

<p id="mathjaxlink" class="pcenter"><a href="chap1_mj.html">[MathJax on]</a></p>
<p><a id="X874E1D45845007FE" name="X874E1D45845007FE"></a></p>
<div class="ChapSects"><a href="chap1.html#X874E1D45845007FE">1 <span class="Heading">Preface</span></a>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap1.html#X869E3CF37EC69123">1.1 <span class="Heading">The <strong class="pkg">GAP</strong> System</span></a>
</span>
</div>
<div class="ContSect"><span class="tocline"><span class="nocss">&nbsp;</span><a href="chap1.html#X7B488D2E8492AB6A">1.2 <span class="Heading">Further Information about <strong class="pkg">GAP</strong></span></a>
</span>
</div>
</div>

<h3>1 <span class="Heading">Preface</span></h3>

<p>Welcome to <strong class="pkg">GAP</strong>. This preface serves not only to introduce this manual, "the <strong class="pkg">GAP</strong> Tutorial", but also as an introduction to the system as a whole.</p>

<p><strong class="pkg">GAP</strong> stands for <em>Groups, Algorithms and Programming</em>. The name was chosen to reflect the aim of the system, which is introduced in this tutorial manual. Since that choice, the system has become somewhat broader, and you will also find information about algorithms and programming for other algebraic structures, such as semigroups and algebras.</p>

<p>In addition to this manual, there is the <em><strong class="pkg">GAP</strong> Reference Manual</em> (see <a href="../../doc/ref/chap1.html#X874E1D45845007FE"><span class="RefLink">Reference: Preface</span></a>) containing detailed documentation of the mathematical functionality of <strong class="pkg">GAP</strong>, and the manual called <em>"<strong class="pkg">GAP</strong> - Changes from Earlier Versions"</em> (see <a href="../../doc/changes/chap1.html#X874E1D45845007FE"><span class="RefLink">Changes: Preface</span></a>) which describes most essential changes from previous <strong class="pkg">GAP</strong> releases.</p>

<p>A lot of the functionality of the system and a number of contributed extensions are provided as "<strong class="pkg">GAP</strong> packages" and each of these has its own manual.</p>

<p>Subsequent sections of this preface explain the structure of the system and list sources of further information about <strong class="pkg">GAP</strong>.</p>

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

<h4>1.1 <span class="Heading">The <strong class="pkg">GAP</strong> System</span></h4>

<p><strong class="pkg">GAP</strong> is a <em>free</em>, <em>open</em> and <em>extensible</em> software package for computation in discrete abstract algebra. The terms "free" and "open" describe the conditions under which the system is distributed -- in brief, it is <em>free of charge</em> (except possibly for the immediate costs of delivering it to you), you are <em>free to pass it on</em> within certain limits, and all of the workings of the system are <em>open for you to examine and change</em>. Details of these conditions can be found in Section <a href="../../doc/ref/chap1.html#X7950EFA183E3F666"><span class="RefLink">Reference: Copyright and License</span></a>.</p>

<p>The system is "extensible" in that you can write your own programs in the <strong class="pkg">GAP</strong> language, and use them in just the same way as the programs which form part of the system (the "library"). Indeed, we actively support the contribution, refereeing and distribution of extensions to the system, in the form of "<strong class="pkg">GAP</strong> packages". Further details of this can be found in chapter <a href="../../doc/ref/chap76.html#X816DC7C580D41F49"><span class="RefLink">Reference: GAP Packages</span></a>, and on our website.</p>

<p>Development of <strong class="pkg">GAP</strong> began at Lehrstuhl D für Mathematik, RWTH-Aachen, under the leadership of Joachim Neubüser in 1985. Version 2.4 was released in 1988 and version 3.1 in 1992. In 1997 coordination of <strong class="pkg">GAP</strong> development, now very much an international effort, was transferred to St Andrews. A complete internal redesign and almost complete rewrite of the system was completed over the following years and version 4.1 was released in July 1999. A sign of the further internationalization of the project was the <strong class="pkg">GAP</strong> 4.4 release in 2004, which has been coordinated from Colorado State University, Fort Collins.</p>

<p>More information on the motivation and development of <strong class="pkg">GAP</strong> to date, can be found on our Web pages in a section entitled "Release history and Prefaces".</p>

<p>For those readers who have used an earlier version of <strong class="pkg">GAP</strong>, an overview of the changes from <strong class="pkg">GAP</strong> 4.4 and a brief summary of changes from earlier versions is given in a separate manual <a href="../../doc/changes/chap3.html#X837AADDA7EA9A541"><span class="RefLink">Changes: Changes between GAP 4.4 and GAP 4.5</span></a>.</p>

<p>The system that you are getting now consists of a "core system" and a number of packages. The core system consists of four main parts.</p>

<ol>
<li><p>A <em>kernel</em>, written in C, which provides the user with</p>


<ul>
<li><p>automatic dynamic storage management, which the user needn't bother about in his programming;</p>

</li>
<li><p>a set of time-critical basic functions, e.g. "arithmetic", operations for integers, finite fields, permutations and words, as well as natural operations for lists and records;</p>

</li>
<li><p>an interpreter for the <strong class="pkg">GAP</strong> language, an untyped imperative programming language with functions as first class objects and some extra built-in data types such as permutations and finite field elements. The language supports a form of object-oriented programming, similar to that supported by languages like C++ and Java but with some important differences.</p>

</li>
<li><p>a small set of system functions allowing the <strong class="pkg">GAP</strong> programmer to handle files and execute external programs in a uniform way, regardless of the particular operating system in use.</p>

</li>
<li><p>a set of programming tools for testing, debugging, and timing algorithms.</p>

</li>
<li><p>a "read-eval-view" style user interface.</p>

</li>
</ul>
</li>
<li><p>A much larger <em>library of <strong class="pkg">GAP</strong> functions</em> that implement algebraic and other algorithms. Since this is written entirely in the <strong class="pkg">GAP</strong> language, the <strong class="pkg">GAP</strong> language is both the main implementation language and the user language of the system. Therefore the user can as easily as the original programmers investigate and vary algorithms of the library and add new ones to it, first for own use and eventually for the benefit of all <strong class="pkg">GAP</strong> users.</p>

</li>
<li><p>A <em>library of group theoretical data</em> which contains various libraries of groups, including the library of small groups (containing all groups of order at most 2000, except those of order 1024) and others. Large libraries of ordinary and Brauer character tables and Tables of Marks are included as packages.</p>

</li>
<li><p>The <em>documentation</em>. This is available as on-line help, as printable files in PDF format and as HTML for viewing with a Web browser.</p>

</li>
</ol>
<p>Also included with the core system are some test files and a few small utilities which we hope you will find useful.</p>

<p><strong class="pkg">GAP</strong> <em>packages</em> are self-contained extensions to the core system. A package contains <strong class="pkg">GAP</strong> code and its own documentation and may also contain data files or external programs to which the <strong class="pkg">GAP</strong> code provides an interface. These packages may be loaded into <strong class="pkg">GAP</strong> using the <code class="func">LoadPackage</code> (<a href="../../doc/ref/chap76.html#X79B373A77B29D1F5"><span class="RefLink">Reference: LoadPackage</span></a>) command, and both the package and its documentation are then available just as if they were parts of the core system. Some packages may be loaded automatically, when <strong class="pkg">GAP</strong> is started, if they are present. Some packages, because they depend on external programs, may only be available on the operating systems where those programs are available (usually UNIX). You should note that, while the packages included with this release are the most recent versions ready for release at this time, new packages and new versions may be released at any time and can be easily installed in your copy of <strong class="pkg">GAP</strong>.</p>

<p>With <strong class="pkg">GAP</strong> there are two packages (the library of ordinary and Brauer character tables, and the library of tables of marks) which contain functionality developed from parts of the <strong class="pkg">GAP</strong> core system. These have been moved into packages for ease of maintenance and to allow new versions to be released independently of new releases of the core system. The library of small groups should also be regarded as a package, although it does not currently use the standard package mechanism. Other packages contain functionality which has never been part of the core system, and may extend it substantially, implementing specific algorithms to enhance its capabilities, providing data libraries, interfaces to other computer algebra systems and data sources such as the electronic version of the Atlas of Finite Group Representations; therefore, installation and usage of packages is recommended.</p>

<p>Further details about <strong class="pkg">GAP</strong> packages can be found in chapter <a href="../../doc/ref/chap76.html#X816DC7C580D41F49"><span class="RefLink">Reference: GAP Packages</span></a>, and on the <strong class="pkg">GAP</strong> website here: <span class="URL"><a href="http://www.gap-system.org/Packages/packages.html">http://www.gap-system.org/Packages/packages.html</a></span>.</p>

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

<h4>1.2 <span class="Heading">Further Information about <strong class="pkg">GAP</strong></span></h4>

<p>Information about <strong class="pkg">GAP</strong> is best obtained from the <strong class="pkg">GAP</strong> website</p>

<p><span class="URL"><a href="http://www.gap-system.org">http://www.gap-system.org</a></span></p>

<p>There you will find, amongst other things</p>


<ul>
<li><p>directions to the sites from which you can download the current <strong class="pkg">GAP</strong> distribution, all accepted and deposited <strong class="pkg">GAP</strong> packages, and a selection of other contributions.</p>

</li>
<li><p>the <strong class="pkg">GAP</strong> manual and an archive of the <code class="code">gap-forum</code> mailing list, formatted for reading with a Web browser, and indexed for searching.</p>

</li>
<li><p>information about <strong class="pkg">GAP</strong> developers, and about the email addresses available for comment, discussion and support.</p>

</li>
</ul>
<p>We would particularly ask you to note the following things:</p>


<ul>
<li><p>The <strong class="pkg">GAP</strong> Forum – an email discussion forum for comments, discussions or questions about <strong class="pkg">GAP</strong>. You must subscribe to the list before you can post to it, see the website for details. In particular we will announce new releases in this mailing list.</p>

</li>
<li><p>The email address <span class="URL"><a href="mailto:support@gap-system.org">support@gap-system.org</a></span> to which you are asked to send any questions or bug reports which do not seem likely to be of interest to the whole <strong class="pkg">GAP</strong> Forum. Please give a (short, if possible) self-contained excerpt of a <strong class="pkg">GAP</strong> session containing both input and output that illustrates your problem (including comments of why you think it is a bug) and state the type of the machine, operating system, (compiler used, if UNIX/Linux) and the version of <strong class="pkg">GAP</strong> you are using (the first line after the <strong class="pkg">GAP</strong> 4 banner starting <code class="code">GAP, Version 4...</code>).</p>

</li>
<li><p>We also ask you to send a brief message to <span class="URL"><a href="mailto:support@gap-system.org">support@gap-system.org</a></span> when you install <strong class="pkg">GAP</strong>.</p>

</li>
<li><p>The correct form of citation of <strong class="pkg">GAP</strong>, which we ask you use whenever you publish scientific results obtained using <strong class="pkg">GAP</strong>.</p>

</li>
</ul>
<p>It finally remains for us to wish you all pleasure and success in using <strong class="pkg">GAP</strong>, and to invite your constructive comment and criticism.</p>

<p>The GAP Group,</p>

<p>20-Jul-2013</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="chap0.html">[Previous Chapter]</a>&nbsp;  &nbsp;<a href="chap2.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="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>