tame/RELEASES.md

TAME Release Notes

This file contains notes for each release of TAME since v17.4.0.

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.

TAME developers: Add new changes under a "NEXT" heading as part of the commits that introduce the changes. To make a new release, run tools/mkrelease, which will handle updating the heading for you.

NEXT

Compiler

• Summary Page now displays values of lv:match/@on instead of debug values.
  • This provides more useful information and is not subject to the confusing reordering behavior of the compiler that is not reflected on the page.
  • Changes that have not yet been merged will remove debug values for the classification system.

Core

• New feature flag template _use-new-classification-system_.
  • This is not yet utilized, but will enable a classification system rewrite once merged.
• Remove core/aggregate.
  • This package is not currently utilized and is dangerous---it could easily aggregate unintended values if used carelessly. Those who know what they are doing can use sym-set if such a thing is a good thing within the given context, and proper precautions are taken (as many templates already do today).

v17.9.0 (2021-05-27)

This is a documentation/design release, introducing The TAME Programming Language in design/tpl.

Compiler

• Allow the mapping of flag values from program.xml.

Design

• Introduce The TAME Programming Language.

v17.8.1 (2021-03-18)

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.

Build System

• [bugfix] Lookup tables will no longer build rater/core/vector/table when 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.
• Minor improvements to tame and tamed scripts to ensure that certain unlikely failures are not ignored.

v17.8.0 (2021-02-23)

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.

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.
  • 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.

Build System

• Only modify .version.xml timestamp when hash changes. This allows its use as a dependency without forcefully rebuilding each and every time.
• 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.
• Step-level imports in program definitions are now recognized to accommodate liza-proguic's step-level package generation.
• Step-level program packages are now properly accounted for as dependencies for builds.
• 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.

v17.7.0 (2020-12-09)

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.

tame-core

• mrange is now fully tail-recursive and has experimental TCO applied.
  • It was previously only recursive for non-matching rows.

v17.6.5 (2020-12-03)

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.

v17.6.4 (2020-11-23)

This release tolerates invalid map inputs in certain circumstances.

Compiler

• Tolerate non-string inputs to uppercase and hash map methods.

v17.6.3 (2020-11-03)

• Update the CDN used to get MathJax.

v17.6.2 (2020-10-01)

• 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.

v17.6.1 (2020-09-23)

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.

Miscellaneous

• package-lock.json additions.

v17.6.0 (2020-08-19)

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.

Miscellaneous

• build-aux/lsimports was causing Gawk to complain about the third argument to gensub; fixed.
• bootstrap will test explicitly whether hoxsl is a symbol link, since -e fails if the symlink is broken.

v17.5.0 (2020-07-15)

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.

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.

v17.4.3 (2020-07-02)

This release fixes a bug caused by previous refactoring that caused unresolved externs to produce an obscure and useless error for the end user.

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.

v17.4.2 (2020-05-13)

This release adds GraphML output for linked objects to allow us to inspect the graph.

Linker

• Add --emit oprion to tamer/src/bin/tameld.rs that allows us to specify the type of output we want.
• Minor refactoring.

Miscellaneous

• Added make target to build linked GraphML files.
• Updated make *.xmle target to explicitly state it is emitting xmle.
• Added Cypher script to use in Neo4J after a GraphML file is imported.
• RELEASES.md
  • Add missing link to semver.org.
  • Fix tame-core heading, which was erroneously Org-mode-styled.
  • Rephrase and correct formatting of an introduction paragraph.

v17.4.1 (2020-04-29)

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.

tame-core

• 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.