-
Notifications
You must be signed in to change notification settings - Fork 160
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Overview of changes in GAP 4.9.1 release #2418
Conversation
2ac6b57
to
11b46ea
Compare
Codecov Report
@@ Coverage Diff @@
## master #2418 +/- ##
=======================================
Coverage 73.96% 73.96%
=======================================
Files 484 484
Lines 245454 245454
=======================================
Hits 181541 181541
Misses 63913 63913
|
doc/changes/changes49.xml
Outdated
(but not yet all: help with this is welcome). Some relevant pull requests: | ||
<List> | ||
<Item> | ||
<!-- [#1165](https://github.com/gap-system/gap/pull/1165) --> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Perhaps these should be turned into actual hyperlinks? E.g. at the end of each entry, have something like (#1234, #1236)
with both PR numbers hyperlinks.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, I had actually a similar thought - good to see someone else expressing it too... Some places already got text like (For some technical details, +see <URL Text="#609">https://github.com/gap-system/gap/pull/609</URL>).
- I am all for doing this for the rest. This will be especially helpful when the description is less than informative or sounds too similar to another entry.
be83fb0
to
4ad909d
Compare
Making PDF version currently produces a number of messages
because it trips over
I've figured out that one can do
and then hash appears in PDF, but from a new line. Not sure what to do except ignoring LaTeX warnings and not having hashes in the PDF version of the manual. |
Thanks @fingolfin - a combination of
and
resolves this. |
4ad909d
to
16d268b
Compare
This seems to be ready for the reviewing, but may later require some updates related to #2431. Also, I will have to update |
doc/changes/changes49.xml
Outdated
<Item> | ||
In addition to supporting single argument lambda functions like | ||
<C>a -> a+1</C>, &GAP; now supports lambdas with fewer or more than | ||
one argument, or even an arbitrary number. E.g. <C>{a,b} -> a+b</C> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think "an arbitrary number" should be changed to "a variable number" (also in the Wiki) for clarity
doc/changes/changes49.xml
Outdated
<C>a -> a+1</C>, &GAP; now supports lambdas with fewer or more than | ||
one argument, or even an arbitrary number. E.g. <C>{a,b} -> a+b</C> | ||
is a shorthand for <C>function(a,b) return a+b; end</C>. For details, | ||
see <Ref BookName="ref" Sect="Function"/>. (For technical details, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Twice "For details", though once "technical"... Perhaps: "For details on how to use this, see REF. For technical details, ..." ?
doc/changes/changes49.xml
Outdated
<URL Text="#490">https://github.com/gap-system/gap/pull/490</URL>). | ||
</Item> | ||
<Item> | ||
Function calls, list accesses and records now can be nested. For example, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
change "records" -> "records accesses"
doc/changes/changes49.xml
Outdated
<URL Text="TransGrp">http://www.math.colostate.edu/~hulpke/transgrp/</URL>. | ||
For backwards compatibility, these are required packages in &GAP; 4.9 | ||
(i.e., &GAP; will not start without them). We plan to change this for | ||
&GAP; 4.10, once all packages which currently implicitly rely on these |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Off-topic, but: Do we have an issue with milestone 4.10 tracking this? E.g. listing all packages that need to be updated; if we have that list, or else a request to create such a list, then notify package authors?
If not, we should perhaps create it, and link to it here?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done in #2434
doc/changes/changes49.xml
Outdated
<Item> | ||
We removed our old home-grown big integer code, and instead always use the | ||
GMP based big integer code. This means that the GMP library now is a | ||
required dependency, not just an optional one. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Perhaps add:
Note that GAP has been using GMP big integer arithmetic for a long time by default, and we also have been bundling GMP with GAP. So this change mostly removed code that was never in use for most user.
doc/changes/changes49.xml
Outdated
computation, has been added for the redistribution. | ||
<P/> | ||
|
||
<Package>HAPprime</Package> package by Paul Smith is no longer redistributed |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add "The" at start of sentence. Also, why is it "XYZ package" here, but "package XYZ" above (different word order)?
doc/changes/changes49.xml
Outdated
|
||
<Package>HAPprime</Package> package by Paul Smith is no longer redistributed | ||
with &GAP;. Part of the code has been incorporated into the <Package>HAP</Package> | ||
package. <Package>HAPprime</Package> source code repository could be found at |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add "The" at start of sentence. And replace "could be" by "can still be". Perhaps also insert "containing the code of the last distributed version" somewhere?
doc/changes/changes49.xml
Outdated
<URL>https://github.com/gap-packages/happrime</URL>. | ||
<P/> | ||
|
||
Also, <Package>ParGAP</Package> package by Gene Cooperman |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
again, insert "the" before the package name.
doc/changes/changes49.xml
Outdated
Also, <Package>ParGAP</Package> package by Gene Cooperman | ||
is no longer redistributed with &GAP; (see | ||
<URL Text="this announcement">https://mail.gap-system.org/pipermail/gap/2018-March/001082.html </URL>). | ||
<Package>ParGAP</Package> source code repository could be found at |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
could -> can; all the same remarks as for HAPPrime apply, though here one could write: "containing the code of the last distributed version, plus some first fixes needed for compatibility for GAP 4.9"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could also insert: "If somebody is interested in repairing this package and taking over its maintenance, so that it can be distributed again, please contact the GAP team." ?
doc/changes/changes49.xml
Outdated
<P/> | ||
|
||
Also, <Package>ParGAP</Package> package by Gene Cooperman | ||
is no longer redistributed with &GAP; (see |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
perhaps insert "because it no longer can be compiled with GAP 4.9" before the "(see "
16d268b
to
53ee863
Compare
Thank you @fingolfin - pushed new version with updated URL format and your comments taken into account. |
doc/changes/changes49.xml
Outdated
(<URL><LinkText>&Hash;1991</LinkText><Link>https://github.com/gap-system/gap/pull/1991</Link></URL>) | ||
</Item> | ||
<Item> | ||
Fix <Ref BookName="ref" Oper="PositionProperty"/> with from < 1 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
from
is an argument, so perhaps <A>from</A>
, or at least <C>from</C>
doc/changes/changes49.xml
Outdated
</Item> | ||
<Item> | ||
Fix <Ref BookName="ref" Oper="QuotientMod"/> documentation, and the integer | ||
implementation. This partially reverts changes made in 2013. The documentation |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Instead of (or in addition to) saying 2013, let's say this was in version GAP 4.7.8, which I think is more helpful for most people.
53ee863
to
88faa20
Compare
Avoided unresolved links and implemented two most recent @fingolfin's suggestions - should be ready for merge. |
Was backported in commit d4f7777 |
This PR adds new Chapter to the Changes manual. It is based on wiki page https://github.com/gap-system/gap/wiki/GAP-4.9-release-notes