employer
/
tame
1
0
Fork 0
Code Packages Releases Activity
tame/RELEASES.md

250 lines
8.5 KiB
Markdown
Raw Normal View History

Release notes and associated scripts This begins providing release notes for changes and provides scripts to facilitate this: - tools/mkrelease will update RELEASES.md and run some checks. - build-aux/release-check is intended for use in pipelines (e.g. see .gitlab-ci.yml) to verify that releases were done properly.
2020-04-29 14:40:55 -04:00
TAME Release Notes
==================
This file contains notes for each release of TAME since v17.4.0.
RELEASES.md: Clarification and formatting fix of intro
2020-04-30 13:06:43 -04:00
TAME uses [semantic versioning][]. Any major version number increment
indicates that backwards-incompatible changes have been introduced in that
version. Each such version will be accompanied by notes that provide a
migration path to resolve incompatibilities.
RELEASES.md: Add missing semver link
2020-04-29 15:48:21 -04:00
[semantic versioning]: https://semver.org/
Release notes and associated scripts This begins providing release notes for changes and provides scripts to facilitate this: - tools/mkrelease will update RELEASES.md and run some checks. - build-aux/release-check is intended for use in pipelines (e.g. see .gitlab-ci.yml) to verify that releases were done properly.
2020-04-29 14:40:55 -04:00
TAME developers: Add new changes under a "NEXT" heading as part of the
commits that introduce the changes. To make a new release, run
RELEASES.md: Clarification and formatting fix of intro
2020-04-30 13:06:43 -04:00
`tools/mkrelease`, which will handle updating the heading for you.
Release notes and associated scripts This begins providing release notes for changes and provides scripts to facilitate this: - tools/mkrelease will update RELEASES.md and run some checks. - build-aux/release-check is intended for use in pipelines (e.g. see .gitlab-ci.yml) to verify that releases were done properly.
2020-04-29 14:40:55 -04:00
RELEASES.md: Summary for next release
2021-03-18 09:55:36 -04:00
RELEASES.md: Update for v17.8.1
2021-03-18 09:56:02 -04:00
v17.8.1 (2021-03-18)
====================
RELEASES.md: Summary for next release
2021-03-18 09:55:36 -04:00
This release contains a bufix for recent build changes in v17.8.0 that were
causing, under some circumstances, builds to fail during dependency
generation. It also contains minor improvements and cleanup.
RELEASES.md: Mention recent tame and tamed changes
2021-03-15 09:49:57 -04:00
Build System
------------
RELEASES.md: Summary for next release
2021-03-18 09:55:36 -04:00
- [bugfix] Lookup tables will no longer build `rater/core/vector/table` when
build-aux/Makefile.am: Lookup table dependency fix %.xml{=>o}: %csvo rater/core/vector/table.xmlo That is: we'll only build an object file when we try to build another object file. This was causing problems with dependency generation, because it will triggering compilation early.
2021-03-17 17:02:58 -04:00
geneating the `xml` package.
- This was causing problems during `suppliers.mk` dependency generation.
The dependency is still in place for the corresponding `xmlo` file.
- This was broken by v17.8.0.
RELEASES.md: Mention recent tame and tamed changes
2021-03-15 09:49:57 -04:00
- Minor improvements to `tame` and `tamed` scripts to ensure that certain
unlikely failures are not ignored.
RELEASES.md: Summary for next release
2021-03-18 09:55:36 -04:00
RELEASES.md: Update for v17.8.0
2021-02-23 10:51:59 -05:00
v17.8.0 (2021-02-23)
====================
build-aux/Makefile.am (.version.xml): Only change timestamp on hash change The timestamp of the file will now only be updated if the hash (version) _actually_ changes. This allows this to be used as a target dependency without forcing a rebuild each and every time.
2021-02-22 12:37:38 -05:00
This release contains changes to the build system to accommodate
liza-proguic's introduction of step-based packages (in place of a monolithic
`package-dfns.xml`), as well as miscellaneous improvements.
src/current/rater.xsd: Update This had gotten quite out of date from the actual rater.xsd, which existed outside of this repository, that is used during our build process. That was an unintended artifact from moving files around. That file has been removed and symlinked to this one.
2021-02-22 14:39:31 -05:00
Compiler
--------
- `rater.xsd`, used for certain validations of TAME's grammar, has been
updated to an out-of-tree version; it had inadvertently gotten out of
date, and the discrepency won't happen again in the future.
src/current/rater.xsd (yieldsNameType): Remove length checks The intent originally was to try to keep developers to a reasonable name length, but generated identifiers can easily exceed this, and we further do not support namespacing. This can be handled at a template level instead for enforcing naming conventions.
2021-02-22 14:41:23 -05:00
- Further, limits on the length of `@yields` identifiers have been
removed; the lack of namespacing and generation of identifiers from
templates can yield longer identifier names.
src/current/rater.xsd: Update This had gotten quite out of date from the actual rater.xsd, which existed outside of this repository, that is used during our build process. That was an unintended artifact from moving files around. That file has been removed and symlinked to this one.
2021-02-22 14:39:31 -05:00
build-aux/Makefile.am (.version.xml): Only change timestamp on hash change The timestamp of the file will now only be updated if the hash (version) _actually_ changes. This allows this to be used as a target dependency without forcing a rebuild each and every time.
2021-02-22 12:37:38 -05:00
Build System
------------
- Only modify `.version.xml` timestamp when hash changes. This allows
its use as a dependency without forcefully rebuilding each and every time.
build-aux/m4/calcdsl.m4: Do not generate suppliers.mk This will be generated automatically by the Makefile. It's not appropriate to generate in the configure script, and I do not recall why I did so---possibly to work around the issue of delayed tab completion when it needs regeneration? This removes suppmk-gen in favor of more generic Makefile targets---in this case, having `%.tdat` depend upon `rater/core/tdat.xml`, even though that's not quite true (the %.xml file generated from it needs it). But these files are going away soon; a pending TAME optimization branch removes support for the underlying pattern primitive entirely; CSVMs should be used instead.
2021-02-22 12:38:38 -05:00
- `configure` will no longer immediately generate `suppliers.mk`.
- Additionally, `build-aux/suppmk-gen`, which `configure` directly invoked
until now, was removed in favor of generic rules in `Makefile.am`.
src/current/pkg-dep.xsl: Recognize step-level imports First thing to note: this belong in liza-proguic, not here. But it's here right now, so for now I'm making the change. The relationship between TAME and proguic is awkward and will hopefully be improved upon in the near future. As for this actual change: step-level fragments will be concatenated such that the imports will appear at the step level rather than the root.
2021-02-22 12:40:31 -05:00
- Step-level imports in program definitions are now recognized to
accommodate liza-proguic's step-level package generation.
build-aux/Makefile.am: Accommodate step-level packages from proguic Note: this really belongs in liza-proguic, and should be moved in the near future. liza-proguic is being modified to generate step-level packages, which are significantly faster to build than larger ones (XSLT TAME scales terribly). These changes handle those new dependencies. One important thing to note with this change is that suppliers.mk now requires proguic to have run before generation so that those generated dependencies can be properly examined. This is a quick operation, so that is not problematic. This also depends on the .version.xml change that was previously made: when the timestamp changed every time, we got into an infinite build loop.
2021-02-22 12:42:16 -05:00
- Step-level program packages are now properly accounted for as dependencies
for builds.
build-aux/Makefile.am (suppliers.mk): Regenerate when any sources change This should have been done many years ago. This will determine if any of the dependencies have changed for the included suppliers.mk and regenerate it as needed, without the developer having to do so manually when imports change.
2021-02-22 16:47:07 -05:00
- `supplier.mk` is now automatically regenerated when source files
change. This previously needed to be done manually when imports changed.
- `supplier.mk` generation will no longer be verbose (it'll instead be
only one line), which makes it more amenable to more frequent
regeneration.
build-aux/Makefile.am (.version.xml): Only change timestamp on hash change The timestamp of the file will now only be updated if the hash (version) _actually_ changes. This allows this to be used as a target dependency without forcing a rebuild each and every time.
2021-02-22 12:37:38 -05:00
RELEASES.md: Update for v17.7.0
2020-12-09 09:59:09 -05:00
v17.7.0 (2020-12-09)
====================
[DEV-8947] Guided TCO: Reassign argument values after processing all expressions I did say it was _experimental_ guided TRO. This waits to perform the actual argument reassignment until after processing the expressions associated with the new arguments, since they will otherwise be replaced when their original values are still needed.
2020-12-02 14:56:38 -05:00
This release provides tail-call optimizations aimed at the query system in
core.
Compiler
--------
- [bugfix] Recursive calls using TCO will wait to overwrite their function
arguments until all expressions calculating the new argument values have
completed.
[DEV-8947] Make mrange fully tail-recursive and enable TCO We were still having issues with this function when taking the positive branch, when predicates cause many matches within tables. This was causing us to hit stack limits in certain browsers on the Summary Page. This converts it to an iterator so that all branches are tail-recursive, and then enables TCO on them. I was disappointed to find that there's little performance or memory benefit in running our test suite.
2020-12-02 16:50:35 -05:00
`tame-core`
-----------
- `mrange` is now fully tail-recursive and has experimental TCO applied.
- It was previously only recursive for non-matching rows.
RELEASES.md: Update for v17.6.5
2020-12-03 14:09:37 -05:00
v17.6.5 (2020-12-03)
[DEV-8927] Improve summary page performance with new element queries
2020-11-30 15:25:18 -05:00
====================
RELEASES.md (v17.6.5): Add missing subheading I also rephrased it a bit. The original phrasing was not incorrect.
2020-12-09 09:55:34 -05:00
This release improves Summary Page performance when populating the page with
data loaded from an external source.
Summary Page
------------
- Populating the DOM with loaded data now runs in linear time.
[DEV-8927] Improve summary page performance with new element queries
2020-11-30 15:25:18 -05:00
map: Tolerate non-string inputs for `uppercase` and `hash` methods This change simply prevents failure in such situations, (e.g. on invalidated fields in Liza). We'll worry about proper errors and correctness, which ought to be compile-time, in TAMER.
2020-11-23 15:20:20 -05:00
RELEASES.md: Update for v17.6.4
2020-11-23 15:26:54 -05:00
v17.6.4 (2020-11-23)
====================
map: Tolerate non-string inputs for `uppercase` and `hash` methods This change simply prevents failure in such situations, (e.g. on invalidated fields in Liza). We'll worry about proper errors and correctness, which ought to be compile-time, in TAMER.
2020-11-23 15:20:20 -05:00
This release tolerates invalid map inputs in certain circumstances.
Compiler
--------
- Tolerate non-string inputs to `uppercase` and `hash` map methods.
RELEASES.md: Update for v17.6.3
2020-11-03 13:24:36 -05:00
v17.6.3 (2020-11-03)
[DEV-8571] Update the MathJax CDN The MathJax CDN stopped working in April 2017. I updated it to the recommended CDN with the last version from April 2017 to ensure it works like it used to work before the CDN stopped. I added the checksum to ensure the content of the script.
2020-11-03 12:37:38 -05:00
====================
- Update the CDN used to get MathJax.
map: Tolerate non-string inputs for `uppercase` and `hash` methods This change simply prevents failure in such situations, (e.g. on invalidated fields in Liza). We'll worry about proper errors and correctness, which ought to be compile-time, in TAMER.
2020-11-23 15:20:20 -05:00
RELEASES.md: Update for v17.6.2
2020-10-01 10:22:17 -04:00
v17.6.2 (2020-10-01)
====================
[DEV-8362] Include program.mk in project root If a "program.mk" exists in a project's root, it should be included in the Makefile. Co-Authored-By: Anthony Dalfonso <anthony.dalfonso@ryansg.com>
2020-09-30 15:25:43 -04:00
- Optionally include a "program.mk" file if it is present in the project's root
directory. This allows us to move program specific tasks outside of TAME.
Release notes and associated scripts This begins providing release notes for changes and provides scripts to facilitate this: - tools/mkrelease will update RELEASES.md and run some checks. - build-aux/release-check is intended for use in pipelines (e.g. see .gitlab-ci.yml) to verify that releases were done properly.
2020-04-29 14:40:55 -04:00
map: Tolerate non-string inputs for `uppercase` and `hash` methods This change simply prevents failure in such situations, (e.g. on invalidated fields in Liza). We'll worry about proper errors and correctness, which ought to be compile-time, in TAMER.
2020-11-23 15:20:20 -05:00
RELEASES.md: Update for v17.6.1
2020-09-23 16:32:19 -04:00
v17.6.1 (2020-09-23)
====================
[DEV-8492] Fail lv:param-class-to-yields rather than awaiting propagation This problem manifested when the name of the attempted classification is the same name as another object. For example, if we have `t:match-class name="foo"`, and `foo` is a param instead of a class, then `@yields` will fail, and it'd fall back to matching on the param. This is absolutely not what we want. The error message in this context is ugly, but it does work. Example: !!! Unknown match @on (/lv:package/lv:classify/match): `error: unable to determine @yields for class `scheduled_ai' (has the class been imported?)' is unknown for classification --vis-scheduled-ai-type
2020-09-23 15:59:20 -04:00
Compiler
--------
- `lv:param-class-to-yields` will now trigger a failure rather than relying
on propagating bad values, which may not result in failure if the symbol
is represented by another type (non-class) of object.
package{,-lock}.json additions These were being changed every time npm was run.
2020-08-19 15:39:20 -04:00
Miscellaneous
-------------
- `package-lock.json` additions.
RELEASES.md: Update for v17.6.0
2020-08-19 15:30:00 -04:00
v17.6.0 (2020-08-19)
====================
tamed: TAMED_JAVA_OPTS: New environment variable This will be passed to dslc and then to the JVM. The intent is to permit fine-grained heap ratio tuning.
2020-08-14 00:03:01 -04:00
This release provides a new environment variable for JVM tuning. It does
not provide any new compiler features or performance enhancements in itself,
though it enables optimizations through JVM tuning.
Compiler
--------
- The new environment variable `TAMED_JAVA_OPTS` can now be used to provide
arguments to the JVM. This feature was added to support heap ratio
tuning.
RELEASES.md: Include mention of lsimports fix
2020-07-23 14:33:06 -04:00
Miscellaneous
-------------
- `build-aux/lsimports` was causing Gawk to complain about the third
argument to `gensub`; fixed.
bootstrap: Check explicitly for hoxsl symbolic link Using `-e` resulted in a situation where a broken symbolic link would cause `ln` to be executed in error.
2020-07-24 15:33:02 -04:00
- `bootstrap` will test explicitly whether `hoxsl` is a symbol link, since
`-e` fails if the symlink is broken.
RELEASES.md: Include mention of lsimports fix
2020-07-23 14:33:06 -04:00
RELEASES.md: Update for v17.5.0
2020-07-15 11:16:14 -04:00
v17.5.0 (2020-07-15)
====================
[DEV-8130] core: mrange: Use experimental guided TCO This alleviates stack exhaustion issues with large rate tables where the predicates fail to reduce the search space to a reasonable size.
2020-07-14 16:53:05 -04:00
This release adds support for experimental human-guided tail call
optimizations (TCO) to resolve issues of stack exhaustion during runtime for
tables with a large number of rows after having applied the first
predicate. This feature should not be used outside of `tame-core`, and will
be done automatically by TAMER in the future.
`tame-core`
-----------
- `vector/filter/mrange`, used by the table lookup system, has had its
mutually recursive function inlined and now uses TCO.
- This was the source of stack exhaustion on tables whose predicates were
unable to filter rows sufficiently.
Experimental guided TCO This implements TCO in the XSLT compiler by requiring a human to manually indicate when a recursive call is in tail position. This was somewhat urgently needed to resolve stack exhaustion on large rate tables. TAMER will do this properly by determining itself whether a call is in tail position. Until then, this will serve as a test for this type of feature.
2020-07-14 16:50:08 -04:00
Compiler
--------
- Experimental guided tail call optimizations (TCO) added to XSLT-based
compiler, allowing a human to manually indicate recursive calls in tail
position.
- This is undocumented and should only be used by `tame-core`. The
experimental warning will be removed in future releases if the behavior
proves to be sound.
- TAMER will add support for proper tail calls that will be detected
automatically.
RELEASES.md: Update for v17.4.3
2020-07-02 12:48:16 -04:00
v17.4.3 (2020-07-02)
====================
RELEASES.md: Summary for NEXT release
2020-07-02 12:47:12 -04:00
This release fixes a bug caused by previous refactoring that caused
RELEASES.md (17.4.3): Fix {product=>produce} typo
2020-07-15 14:38:07 -04:00
unresolved externs to produce an obscure and useless error for the end
RELEASES.md: Summary for NEXT release
2020-07-02 12:47:12 -04:00
user.
[DEV-8000] ir::asg: Error types for unresolved identifiers during sorting This checks explicitly for unresolved objects while sorting and provides an explicit error for them. For example, this will catch externs that have no concrete resolution. This previously fell all the way through to the unreachable! block. The old POC implementation was catching unresolved objects, albeit with a debug error.
2020-07-01 15:40:21 -04:00
Linker
------
- Provide useful error for unresolved identifiers.
- This was previously falling through to an `unreachable!` block,
producing a very opaque and useless internal error message.
RELEASES.md: Update for v17.4.2
2020-05-13 08:09:48 -04:00
v17.4.2 (2020-05-13)
====================
[DEV-7504] Add GraphML generation We want to be able to build a representation of the dependency graph so we can easily inspect it. We do not want to make GraphML by default. It is better to use a tool. We use "petgraph-graphml".
2020-04-30 14:33:10 -04:00
This release adds GraphML output for linked objects to allow us to
[DEV-7504] Update RELEASES.md to make it less technical
2020-05-13 07:27:34 -04:00
inspect the graph.
[DEV-7504] Add GraphML generation We want to be able to build a representation of the dependency graph so we can easily inspect it. We do not want to make GraphML by default. It is better to use a tool. We use "petgraph-graphml".
2020-04-30 14:33:10 -04:00
Linker
------
- Add `--emit` oprion to `tamer/src/bin/tameld.rs` that allows us to specify
the type of output we want.
[DEV-7504] Update RELEASES.md to make it less technical
2020-05-13 07:27:34 -04:00
- Minor refactoring.
[DEV-7504] Add GraphML generation We want to be able to build a representation of the dependency graph so we can easily inspect it. We do not want to make GraphML by default. It is better to use a tool. We use "petgraph-graphml".
2020-04-30 14:33:10 -04:00
Miscellaneous
-------------
[DEV-7504] Add make target for "graphml"
2020-05-01 13:33:41 -04:00
- Added `make` target to build linked GraphML files.
- Updated `make *.xmle` target to explicitly state it is emitting `xmle`.
[DEV-7504] Add cypher script for post-graph import After we import the GraphML output into Neo4J, we need to make a few modifications to make the data easier to work with.
2020-05-13 07:24:02 -04:00
- Added Cypher script to use in Neo4J after a GraphML file is imported.
RELEASES.md: Fix tame-core heading
2020-04-29 15:49:57 -04:00
- `RELEASES.md`
- Add missing link to semver.org.
- Fix `tame-core` heading, which was erroneously Org-mode-styled.
RELEASES.md: Clarification and formatting fix of intro
2020-04-30 13:06:43 -04:00
- Rephrase and correct formatting of an introduction paragraph.
RELEASES.md: Add missing semver link
2020-04-29 15:48:21 -04:00
RELEASES.md: Update for v17.4.1
2020-04-29 15:34:29 -04:00
v17.4.1 (2020-04-29)
====================
Release notes and associated scripts This begins providing release notes for changes and provides scripts to facilitate this: - tools/mkrelease will update RELEASES.md and run some checks. - build-aux/release-check is intended for use in pipelines (e.g. see .gitlab-ci.yml) to verify that releases were done properly.
2020-04-29 14:40:55 -04:00
This release refactors the linker, adds additional tests, and improves
errors slightly. There are otherwise no functional changes.
Compiler
--------
- Refactor proof-of-concept dependency graph construction code.
- Improvements to error abstraction which will later aid in reporting.
Miscellaneous
-------------
- `RELEASES.md` added.
- `tools/mkrelease` added to help automate updating `RELEASES.md`.
- `build-aux/release-check` added to check releases.
- This is invoked both by `tools/mkrelease` and by CI via
`.gitlab-ci.yml` on tags.
v17.4.0 (2020-04-17)
====================
This release focuses on moving some code out of the existing XSLT-based
compiler so that the functionality does not need to be re-implemented in
TAMER. There are no user-facing changes aside form the introduction of two
new templates, which are not yet expected to be used directly.
RELEASES.md: Fix tame-core heading
2020-04-29 15:49:57 -04:00
`tame-core`
Release notes and associated scripts This begins providing release notes for changes and provides scripts to facilitate this: - tools/mkrelease will update RELEASES.md and run some checks. - build-aux/release-check is intended for use in pipelines (e.g. see .gitlab-ci.yml) to verify that releases were done properly.
2020-04-29 14:40:55 -04:00
-----------
- New `rate-each` template to replace XSLT template in compiler.
- New `yields` template to replace XSLT template in compiler.
- Users should continue to use `rate-each` and `yields` as before rather
than invoking the new templates directly.
- The intent is to remove the `t` namespace prefix in the future so that
templates will be applied automatically.
Compiler
--------
- XSLT-based compiler now emits `t:rate-each` in place of the previous XSLT
template.
- XSLT-based compiler now emits `t:yields` in place of the previous XSLT
template.