> < ^ Date: Tue, 16 Jan 1996 08:14:28 +0100
> < ^ From: Volkmar Felsch <Volkmar.Felsch@Math.RWTH-Aachen.DE >
> ^ Subject: Non up-to-date examples in the manual

The purpose of this message is to warn you of the fact that there
are some non up-to-date examples in the manual chapters on "Algebraic
extensions of fields" and on the code theory package "Guava".

At the end of the GAP manual section 1.1 you will find the following
claim.

The examples of GAP sessions given in any particular chapter of
this manual have been run in one continuous session, starting with
the two commands

SizeScreen( [ 72, ] );
LogTo( "erg.log" );

which are used to set the line length to 72 and to save a listing
of the session on some file. If you choose any chapter and rerun
its examples in the given order, you should be able to reproduce
our results except of a few lines of output which we have edited
a little bit with respect to blanks or line breaks in order to
improve the readability. However, as soon as random processes are
involved, you may get different results if you extract single
examples and run them separately.

Our experience shows that any correction, improvement, or extension
of GAP may affect several examples in several chapters of the
manual. Therefore it is necessary to rerun and to update a l l
examples whenever we prepare a new GAP release. In particular, we
had to do this for the recent patch 3.4.3 and, in fact, we thought
that we had run all the checks when we released the patch.

However, now it turned out that by some accident we have missed so
far to apply the procedure to the three manual chapters which were
new in the patches 3.4.1 or 3.4.2. The consequence is that some non
up-to-date (or even wrong) examples have survived in two chapters
of the current manual. Therefore we offer updated versions of these
two chapters.

Chapter 16. "Algebraic extensions of fields"

There are only a few changes, and they are harmless. The most
essential alterations are the correction of a wrong result and
the replacement of an example by a more appropriate one because
the original one took several CPU hours.

Chapter 60. "Guava"

There are several modifications in the examples of the updated
version, but most of these changes are just due to the fact that
the output format of certain GUAVA functions has slightly changed
since they were first implemented in GAP. We also have updated
the calls of two functions whose names have changed. Moreover, we
have fixed a few examples that were not quite correct, and we
have inserted the call of the RequirePackage function which is
needed at the beginning of the first example.

In case that you want to reprint these two manual chapters, you may
obtain the updated files algext.tex and guava.tex via anonymous
ftp from

ftp.math.rwth-aachen.de:/pub/incoming/

We would like to apologize for any inconvenience caused by the fact
that we missed to fix these files in time.

Volkmar Felsch (Aachen)


> < [top]