From dd3432c6ea21025a938431bd0dc0bcffb6e99eb5 Mon Sep 17 00:00:00 2001
From: Max Horn <max@quendi.de>
Date: Sun, 16 Sep 2018 23:56:02 +0200
Subject: [PATCH] Version 1.3

There are still many unresolved issues, but it's better to make a release
now, so that people can get their hands on the many changes that were made
since 1.2.5.
---
 CHANGES       | 26 ++++++++++++++++++++------
 PackageInfo.g |  5 ++---
 regen_doc.g   |  4 ++++
 3 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/CHANGES b/CHANGES
index e665535cf..8a456cdd2 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,12 +1,26 @@
 This file describes changes in the recog package.
 
-1.3 (YYYY-MM-DD)
-  - Require GAP >= 4.9
-  - Merge recogbase package into recog
-  - Remove a lot of dead code
-  - Add comments throughout the codebase (e.g. notes on the origin
+1.3 (2018-09-16)
+  - Requires GAP >= 4.9
+  - Merge the recogbase package into recog
+  - Remove tons of unused code & files
+  - Add many comments throughout the codebase (e.g. notes on the origin
     of some algorithms; FIXME and TODO remarks; ...)
-  - Add input validation to some more homomorphisms
+  - Fix many bugs in the recognition code leading to errors or incorrect recognitions
+  - Replace involution finder for SL_2 in even characteristic (faster & less buggy)
+  - Add more tests
+  - Set up continuous integration using Travis CI, to ensure new code changes
+    are immediately tested for regressions
+  - Introduce self-explanatory names for recognition method results
+    (true -> Success, false -> NeverApplicable, fail -> TemporaryFailure,
+    NotApplicable -> NotEnoughInformation); this revealed various bugs where
+    the wrong values were returned
+  - Refactor CallMethods, to make it easier to understand and work on
+  - Improve the documentation; in particular, the tables of recognition methods
+    with their rankings are now generated from the code, and thus are always
+    up-to-date (previously, they were from that)
+  - Add Randomize methods for non-compressed vectors to support fields with more than 256 elements (fixes issue #15)
+  - Many other small changes, cleanups, etc.
 
 1.2.5 (2016-03-08)
   - Maintenance release
diff --git a/PackageInfo.g b/PackageInfo.g
index 9947e0c18..e7963902e 100644
--- a/PackageInfo.g
+++ b/PackageInfo.g
@@ -22,8 +22,8 @@ SetPackageInfo( rec(
 
 PackageName := "recog",
 Subtitle := "A collection of group recognition methods",
-Version := "1.3dev",
-Date := "08/03/2016", # dd/mm/yyyy format
+Version := "1.3",
+Date := "16/09/2018", # dd/mm/yyyy format
 
 ##  Information about authors and maintainers.
 Persons := [
@@ -250,7 +250,6 @@ PackageDoc := rec(
 Dependencies := rec(
   GAP := ">=4.9",
   NeededOtherPackages := [
-    ["GAPDoc", ">= 1.2"],
     ["Forms", ">= 1.2"],
     ["genss", ">= 1.3"],
     ["Orb", ">= 3.4"],
diff --git a/regen_doc.g b/regen_doc.g
index 992d78720..80aa05e9f 100644
--- a/regen_doc.g
+++ b/regen_doc.g
@@ -7,6 +7,8 @@ GenerateMethodsXML := function(shortname, desc, db)
 local xmlfile, meth;
 
     xmlfile := Concatenation("doc/methods_", shortname, "_table.xml");
+    xmlfile := OutputTextFile(xmlfile, false);
+    SetPrintFormattingStatus(xmlfile, false);
 
     PrintTo(xmlfile, "<Table Align=\"|l|l|l|l|\">\n");
     AppendTo(xmlfile, "<Caption>", desc, " group find homomorphism methods</Caption>\n");
@@ -25,6 +27,8 @@ local xmlfile, meth;
 
     AppendTo(xmlfile, "</Table>\n");
 
+    CloseStream(xmlfile);
+
 end;
 
 GenerateMethodsXML("matrix", "Matrix", FindHomDbMatrix);