= p_group_cohomology-1.0 =
== Description ==
Modular Cohomology Rings of Finite p-Groups
The documentation of the package is provided at
http://sage.math.washington.edu/home/SimonKing/Cohomology/
== License ==
Copyright (C) 2009 Simon A. King and
David J. Green
Distributed under the terms of the GNU General Public License (GPL),
version 2 or later (at your choice).
This code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
The full text of the GPL is available at:
http://www.gnu.org/licenses/
The package includes a data base of cohomology rings of the groups of
order 64 and provides access to a data base of cohomology rings of the
groups of order 128 and 243, located at
http://sage.math.washington.edu/home/SimonKing/Cohomology/db/
These data bases are distributed under the Creative Commons
Attribution-Share Alike 3.0 License. The full text of this licence is
available at
http://creativecommons.org/licenses/by-sa/3.0/
== SPKG Maintainers ==
Simon A. King
== Upstream Contact ==
Simon A. King
David J. Green
== Dependencies ==
- The SmallGroups library needs to be installed.
- For p-groups with a prime p>2, we require Singular at least in version 3-1-0.
== Special Update/Build Instructions ==
The package is very likely to not build or at least to not work properly
on Motorola processors (because of endianness).
Note that most of the code is original. Therefore we included the files from
src into the Mercurial repository.
The package includes a modified version of the Aachen C-MeatAxe. Since the
changes are major, we included the modified sources into the Mercurial
repository. A MeatAxe version that comes closest to what we started with
is provided in the folder mtxoriginal.
== Testing ==
Our package does not provide a separate test suite for the MeatAxe C-library or
David Green's routines for the computation of minimal projective resolutions.
But it is of course equipped with extensive doc tests in the Cython code.
The scripts ``spkg-check`` and ``spkg-check-quickly`` walk through all public
methods of all classes in all modules of our package and perform the respective
doc test. ``spkg-check-quickly`` runs over many doc tests at once, which is
faster, but makes it sometimes difficult to find out which doc test actually
failed. Moreover, since the same Singular sub-process is used for all tests,
errors might occur by creating too many temporary variables in the Singular
interface (this only occurs on some machines).
Therefore, we recommend to use ``spkg-check`` for testing. It tells exactly
which doc test failed, and it launches a clean Singular process for any
example. Both test suites also check whether there is any method without a
doc test.
== Changelog ==
* 1.0: First public version (July 2009)
* 1.0.1: Licensing GPL 2 or later (July 2009)