Spoofax 2.2.0 Migration Guide

This page is a stub for the migration guide of Spoofax 2.2. Please write down neccessary migration steps, so that we can quickly release Spoofax 2.2.0 when it is ready.

Spoofax Core

Changes

The language discovery API was refactored into 2 separate types: a low-level interface for requesting creation of language components ILanguageComponentFactory, and a high-level interface ILanguageDiscoveryService that acts as a facade for loading language components and implementations.

The existing methods are still available, but are deprecated and will be removed after the next release. You should change your code to use the new methods. The deprecation documentation on the Java methods show which new methods to use.

Eclipse

Eclipse Neon (4.6) is now required. The Eclipse instances with integrated Spoofax we generate are already using Neon. However, if you manage your own Eclipse instance, you will need to upgrade to Neon.

SDF3

Changes

Move the placeholder and pretty-print options in the metaborg.yaml file to be under language.sdf, as in:
language:
  sdf:
    placeholder:
      prefix: "[["
      suffix: "]]"
    pretty-print: LangName