README

The Semifields for Magma distribution of software for integration in the 
computer algebra system MAGMA, V2.22 and beyond. It contains a database of 
semifields, which is built on the eMAGma package. 

This software was created by Joshua Maglione, Copyright 2018. Distributed under 
GNU GPLv3.


==== Copying ===================================================================

    This program is free software: you can redistribute it and/or modify it 
  under the terms of the GNU General Public License as published by the Free 
  Software Foundation, either version 3 of the License, or (at your option) any
  later version.

    This program 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.

    You should have received a copy of the GNU General Public License along with
  this program. If not, see <http://www.gnu.org/licenses/>.


==== Package Contents ==========================================================

  1. Spec file is "./SemiMag.spec"
  2. Source Code is contained in the folder "src"
  3. Examples are included in the folder "examples" (currently missing)
  4. Documentation is included as "SemiMag.pdf" in "doc"
  5. Example files are demonstrated in "SemiMag.pdf" and their file names 
     coincide with their example title in the text. (currently missing)
  6. Performance and debugging tests are contained in the folder "tests" 
     (currently missing).


==== Installation ==============================================================

    Attach the spec file during a Magma run and the intrinsics will be available
  to use.  To attach the spec file run the following, where <location> is the 
  directory containing the SemiMag directory,

    > AttachSpec("<location>/SemiMag/SemiMag.spec");


==== Latest Versions ===========================================================

  Current version: 0.2.
  Latest versions can be downloaded on GitHub at:
    https://github.com/joshmaglione/SemiMag


==== Feedback, Bugs, and Contributions =========================================

    We welcome general feedback about the package and challenging examples. To 
  report bugs, please create an "Issue" on SemiMag repository site on GitHub. 
  Contributions are always welcome. To contribute, please fork a copy of SemiMag
  and create a pull request.