/usr/share/gap/doc/ref/chap77.txt is in gap-online-help 4r8p8-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 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 |
[1X77 [33X[0;0YReplaced and Removed Command Names[133X[101X
[33X[0;0YIn general we try to keep [5XGAP[105X 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.[133X
[33X[0;0YIn 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.[133X
[33X[0;0YThe obsolete [5XGAP[105X code is collected in two library files, [11Xlib/obsolete.gd[111X and
[11Xlib/obsolete.gi[111X. By default, these files are read when [5XGAP[105X is started. It
may be useful to omit reading these files, for example in order to make sure
that one's own [5XGAP[105X code does not rely on the obsolete variables. For that,
one can use the [10X-O[110X command line option (see [14X3.1[114X) or set the component
[10XReadObsolete[110X in the file [11Xgap.ini[111X to [9Xfalse[109X (see [14X3.2[114X). Note that [10X-O[110X command
line option overrides [10XReadObsolete[110X.[133X
[33X[0;0Y(Note that the condition whether the library files with the obsolete [5XGAP[105X
code shall be read has changed. In [5XGAP[105X 4.3 and 4.4, the global variables
[10XGAP_OBSOLESCENT[110X and [10XGAPInfo.ReadObsolete[110X –to be set in the user's [11X.gaprc[111X
file– were used to control this behaviour.)[133X
[1X77.1 [33X[0;0YGroup Actions – Name Changes[133X[101X
[33X[0;0YThe concept of a group action is sometimes referred to as a [21Xgroup operation[121X.
In [5XGAP[105X 3 as well as in older versions of [5XGAP[105X 4 the term [10XOperation[110X was used
instead of [10XAction[110X. We decided to change the names to avoid confusion with
the term [21Xoperation[121X as in [2XDeclareOperation[102X ([14X79.18-6[114X) and [21Xoperations for Xyz[121X.[133X
[33X[0;0YHere are some examples of such name changes.[133X
[13XOLD[113X │ [13XNOW USE[113X
────────────────────────┼──────────────────────────────
[10XOperation[110X │ [2XAction[102X ([14X41.7-2[114X)
[10XRepresentativeOperation[110X │ [2XRepresentativeAction[102X ([14X41.6-1[114X)
[10XOperationHomomorphism[110X │ [2XActionHomomorphism[102X ([14X41.7-1[114X)
[10XFunctionOperation[110X │ [2XFunctionAction[102X ([14X41.12-4[114X)
[1X77.2 [33X[0;0YPackage Interface – Obsolete Functions and Name Changes[133X[101X
[33X[0;0YWith [5XGAP[105X 4.4 the package interface was changed. Thereby some functions
became obsolete and the names of some others were made more consistent.[133X
[33X[0;0YThe following functions are no longer needed: [10XDeclarePackage[110X,
[10XDeclareAutoPackage[110X, [10XDeclarePackageDocumentation[110X and
[10XDeclarePackageAutoDocumentation[110X. They are substituted by entries in the
packages' [11XPackageInfo.g[111X files, see [14X76.3-12[114X.[133X
[33X[0;0YFurthermore, the global variable [10XPACKAGES_VERSIONS[110X is no longer needed,
since this information is now contained in the [10XGAPInfo.PackagesInfo[110X record
(see [14X3.5-1[114X). The global variable [10XRevisions[110X is also no longer needed, since
the function [10XDisplayRevision[110X was made obsolete in [5XGAP[105X 4.5.[133X
[33X[0;0YThe following function names were changed.[133X
[13XOLD[113X │ [13XNOW USE[113X
───────────────┼───────────────────────
[10XRequirePackage[110X │ [2XLoadPackage[102X ([14X76.2-1[114X)
[10XReadPkg[110X │ [2XReadPackage[102X ([14X76.3-1[114X)
[10XRereadPkg[110X │ [2XRereadPackage[102X ([14X76.3-1[114X)
[1X77.3 [33X[0;0YNormal Forms of Integer Matrices – Name Changes[133X[101X
[33X[0;0YFormer versions of [5XGAP[105X 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 [2XNormalFormIntMat[102X ([14X25.2-9[114X) and a
few interface functions.[133X
[1X77.4 [33X[0;0YMiscellaneous Name Changes or Removed Names[133X[101X
[33X[0;0YIn former releases of [5XGAP[105X 4 there were some global variable names bound to
general information about the running [5XGAP[105X, 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 [10XBANNER[110X and [10XQUIET[110X. This
type of information is now collected in the global record [2XGAPInfo[102X ([14X3.5-1[114X).[133X
[33X[0;0YHere are some further name changes.[133X
[13XOLD[113X │ [13XNOW USE[113X
────────────────────────┼────────────────────────────────
[10XMonomialTotalDegreeLess[110X │ [2XMonomialExtGrlexLess[102X ([14X66.17-14[114X)
[10XNormedVectors[110X │ [2XNormedRowVectors[102X ([14X61.9-11[114X)
[10XMutableIdentityMat[110X │ [2XIdentityMat[102X ([14X24.5-1[114X)
[10XMutableNullMat[110X │ [2XNullMat[102X ([14X24.5-2[114X)
[33X[0;0YThe operation [10XPositionFirstComponent[110X has been deprecated in GAP 4.8 and
later due to issues with its documentation and implementation. Instead of
[10XPositionFirstComponent(list,obj)[110X, you may use [10XPositionSorted(list,[obj])[110X or
[10XPositionProperty(list,x->x[1]=obj)[110X as a replacement, depending on your
specific use case.[133X
[1X77.4-1 InfoObsolete[101X
[33X[1;0Y[29X[2XInfoObsolete[102X[32X info class[133X
[33X[0;0Yis 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 [5XGAP[105X will detect that an
obsolete variable is used at runtime (this detection is possible, however,
only for obsolete variables declared using [10XDeclareObsoleteSynonym[110X).[133X
[33X[0;0YTo check that the [5XGAP[105X code does not use obsolete variables at the parsing
time, and not at a runtime, use [10X-O[110X command line option, see [14X3.1[114X.[133X
[1X77.5 [33X[0;0YThe former .gaprc file[133X[101X
[33X[0;0YUp to [5XGAP[105X 4.4, a file [11X.gaprc[111X in the user's home directory (if available, and
[5XGAP[105X was started without [10X-r[110X option) was read automatically during startup,
early enough for influencing the autoloading of packages and late enough for
being allowed to execute any [5XGAP[105X code. On Windows machines this file was
called [11Xgap.rc[111X.[133X
[33X[0;0YIn [5XGAP[105X 4.5 the startup mechanism has changed, see [14X3.2[114X for details. These new
configuration files are now contained in a directory [10XGAPInfo.UserGapRoot[110X.[133X
[33X[0;0YFor the sake of partial backwards compatibility, also the former file
[11X~/.gaprc[111X is still supported for such initializations, but this file is read
only if the directory [10XGAPInfo.UserGapRoot[110X does not exist. In that case the
[11X~/.gaprc[111X is read at the same time as [11Xgaprc[111X would be read, i. e., too late
for influencing the startup of [5XGAP[105X.[133X
[33X[0;0YAs before, the command line option [10X-r[110X disables reading [11X~/.gaprc[111X, see [14X3.1[114X.[133X
[33X[0;0YTo migrate from the old setup to the new one introduced with [5XGAP[105X 4.5, first
have a look at the function [2XWriteGapIniFile[102X ([14X3.2-3[114X). Many users will find
that all or most of what was set in the old [11X~/.gaprc[111X file can now be done
via the user preferences in a [11Xgap.ini[111X file. If you had code for new
functions or abbreviations in your old [11X~/.gaprc[111X file or you were reading
additional files, then move this into the file [11Xgaprc[111X (without the leading
dot, same name for all operating systems) in the directory
[10XGAPInfo.UserGapRoot[110X.[133X
[1X77.6 [33X[0;0YSemigroup properties[133X[101X
[33X[0;0YUntil Version 4.8 of [5XGAP[105X there was inconsistent use of the following
properties of semigroups: [10XIsGroupAsSemigroup[110X, [10XIsMonoidAsSemigroup[110X, and
[10XIsSemilatticeAsSemigroup[110X. [10XIsGroupAsSemigroup[110X was true for semigroups that
mathematically defined a group, and for semigroups in the category [2XIsGroup[102X
([14X39.2-7[114X); [10XIsMonoidAsSemigroup[110X was true for semigroups that mathematically
defined monoids, but did not belong to the category [2XIsMonoid[102X ([14X51.2-1[114X); and
[10XIsSemilatticeAsSemigroup[110X was simply a property of semigroups, there is no
category [10XIsSemilattice[110X.[133X
[33X[0;0YFrom Version 4.8 onwards, [10XIsSemilatticeAsSemigroup[110X is renamed [10XIsSemilattice[110X,
and [10XIsMonoidAsSemigroup[110X returns [10Xtrue[110X for semigroups in the category [2XIsMonoid[102X
([14X51.2-1[114X).[133X
[1X77.6-1 IsSemilatticeAsSemigroup[101X
[33X[1;0Y[29X[2XIsSemilatticeAsSemigroup[102X( [3XS[103X ) [32X property[133X
[33X[0;0Y[10XIsSemilatticeAsSemigroup[110X returns [9Xtrue[109X if the semigroup [3XS[103X is a semilattice
and [9Xfalse[109X if it is not.[133X
[33X[0;0YA semigroup is a [13Xsemilattice[113X if it is commutative and every element is an
idempotent. The idempotents of an inverse semigroup form a semilattice. This
is identical to [2XIsSemilattice[102X ([14XIsSemilattice???[114X) # and is present in [5XGAP[105X 4.8
# only for the sake of compatibility with beta-releases. # It should [13Xnot[113X be
used in new code.[133X
|