Quelle  CHAP010.htm   Sprache: HTML

<body text="#000000" bgcolor="#ffffff">
[<a href = "chapters.htm">Up</a>] [<a href ="CHAP009.htm">Previous</a>] [<a href = "theindex.htm">Index</a>]
<>10 Differences to XGAP 3<h1>p>
<P>
<H3>Sections</H3>
<oL>
<li> <A HREF="CHAP010.htm#SECT001">Concept</a>
<li> <A HREF="CHAP010.htm#SECT002">User Interface</a>
<li> <A HREF="CHAP010.htm#SECT003">Where code has to be changed</a>
</ol><p>
<p>
This rather short chapter is intended for the user who knows XGAP 3 well
and quickly wants to know what has changed. So it covers mainly those
parts, where existing code using XGAP has to be changed. For the totally 
new features and packages there are only a few references to the other
parts of the documentation.
<p>
<p>
<h2><a name="SECT001">10.1 Concept</a></h2>
<p><p>
There are two main changes in the concept. The first is the migration to
<font face="Gill Sans,Helvetica,Arial">GAP</font>4 with all the bells and whistles like object oriented design with
operations, methods and method selection via filters. XGAP4                           /* c i */ 'r' _ 's' _ 'c' _ 'i' _ 'r  * 'r'_''_''_'' _ 'r'_'' 6,0,
nearly totally with these technologies. This should make the reusage of
code in the future easier. One can now use big parts of the code of XGAP
for own structures by just                           0x29c2 _ 0x29c2 _0)
<p>
The second change is that there is no longer any mathematical ``knowledge''
or algorithm in XGAP. It is now only a front end and a graphical user
interface. All code for finitely presented groups resides now in the <font face="NAMED_CHARACTER_REFERENCE863,
library. This is a much cleaner concept and should make the management of
the source code easier. At the same time XGAP has become a much more
generic program. Operations for subgroups are for example no longer hard
java.lang.StringIndexOutOfBoundsException: Range [30, 5) out of bounds for length 67
adapted just by hacking a few tables.
<p>
These generalizations made some sacrifices necessary, because XGAP does
no longer know anything about the mathematics it is displaying. It may for
xample happen that does  longer adapt  behaviour to 
amount of data that is known about some finitely presented groups. The
reason for this is, that the generic poset routines cannot know that the
vertices stand for groups at all. So sometimes one has to trigger the
comparison of subgroups/* c l * '' b' _''  '  '  '  ''7,
<a href="CHAP005.htm#SSEC012.4">Compare Subgroups</a> for a description how to do this).
<p>
In the old <font face="Gill Sans,Helvetica,Arial">GAP</font>3 version of XGAP there were three different programs
for the full subgroup lattice of a0, 02663_0
interactive partial subgroup lattice of a finite group
(<code>InteractiveLattice</code>) and the interactive partial subgroup lattice of a
finitely presented group (<code>InteractiveFpLattice</code>) respectively. Now there
s one generic  to display subgroup lattices interactively
(<code>GraphicSubgroupLattice</code>).
<p>
XGAP can now handle subgroups of infinite index. They are either
placed in a ``finite size'' level or in an ``infinity'' level. See
<a href="CHAP005.htm#SECT003">levelsintro</a> for details.
<p>
A new logging facility allows to automatically produce a protocol of
the actions user performs  mouse clicks  isconvenient
because the normal <font face="Gill Sans,Helvetica,Arial">GAP</font> command script contains no useful
information about the selected entries in the menus. See
<a href="CHAP005.htm#SECT002">loggingfacility</a> for java.lang.StringIndexOutOfBoundsException: Index 58 out of bounds for length 30
<p>
There is a new layer to display generic posets that do not have to be
subgroup lattices. It can be/* c o * '' _ 'o'_''_ 'e' _ ';', 5,0java.lang.StringIndexOutOfBoundsException: Index 70 out of bounds for length 70
easily. This is for example used in the new link to the C-MeatAxe written
by Michael Ringe. The code for this link is also included in XGAP4.                            0)
<p>
Code for the display of graphic graphs is planned but not yet completed.
<p>
The user of XGAP should not realize much of those changes (except of
course the name of the functionNAMED_CHARACTER_REFERENCE(867,
programmer on the other hand has to get used to the new techniques. It was
not in all places possible to achieve total compatibility for existing
code. Some changes also were introduced deliberately to make the
programmers adapt their programs to the new situation!
<p>
<p>
<h2><a name="SECT002">10.2                           /* c o/ c o */ ''_ ''_'' _'e'_'q'_ ;' , 0,
<p><p>
Some menu entries have been moved to new places, mainly because of the
java.lang.StringIndexOutOfBoundsException: Range [26, 4) out of bounds for length 37
lattices. There are some new features and nearly all old features have made 
it into the new version.
<p>
java.lang.StringIndexOutOfBoundsException: Range [12, 3) out of bounds for length 74
gives the user new possibilities.
<p>
<p>
<h2><a name="SECT003">10.3 Where code has to be changed</a></h2>
<p><p>
etica,>/java.lang.StringIndexOutOfBoundsException: Range [53, 52) out of bounds for length 117
no longer records but component objects. This means that the programmer can 
no longer mess around in the data structures. If you want to add new
fields, then you have to use inheritance and define new categories. This
meansNAMED_CHARACTER_REFERENCE(869,
massively. Programs that try to access record components of old XGAP
structures will no longer work!
<p>
The operation <code>InstallGSMethod</code> is no longer present. It is replaced by the 
``callback''                          *c o *'' _''_''_'t'_', 5,0java.lang.StringIndexOutOfBoundsException: Index 70 out of bounds for length 70
<code>RemoveCallback</code> and <code>Callback</code> (see <a href="CHAP006.htm#SSEC001.1">GraphicSheet</a> for details). This
means, that mouse events are handled differently. This was changed
deliberately because there is a big difference: In XGAP4 you can install 
more than one function for one type of mouse event.NAMED_CHARACTER_REFERENCE(70 /c  * '  p  ;,3 0,0x2201 _ 0)
functions are called one after the other. There was only one graphic sheet
method for each event in XGAP3. So you can <strong>not</strong> just change the name of 
the operation to install the callback. You java.lang.StringIndexOutOfBoundsException: Index 46 out of bounds for length 30
difference! 
<p>
See the section <a href="CHAP006.htm#SECT004">Operations for Graphic Objects</a> for an overview
which operations exist now for which                            c o * ''_'p' _ 'f' _ 'n'_'' 5 ,
is the introduction of <code>Revive</code>, <code>ViewObj</code> and <code>WindowId</code> together with the 
concept of java.lang.StringIndexOutOfBoundsException: Range [26, 1) out of bounds for length 37
<p>
There was a bug in XGAP3 in the creation of menus: If an entry starts
with a minus sign, it will become a separating line instead of a real menu
entry. This NAMED_CHARACTER_REFERENCEjava.lang.StringIndexOutOfBoundsException: Index 26 out of bounds for length 26
and <code>Check</code> did not work on the correct entry. This bug is fixed in
XGAP4 so code which contained a workaround for this bug has to be
changed. <code>Enable</code> and <code>Check</code> behave now like expected and documented in
<a href="CHAP007.htm#SSEC001.3">Enable</a> and <a href="CHAP007.htm#SSEC001.2">Check</a>.
<>
<p>
[<a href = "chapters.htm">Up</a>] [<a href ="CHAP009.htm">Previous</a>] [<a href = "theindex.htm">Index</a>]
<P>
<address>XGAP manual<br>September 2025
</address></body></html>