Sourced from antlr4-runtime's releases.

4.10.1

Tiny update to fix build issue where java requirement for runtime was 11 not 1.8.

What's Changed

• [C++] Remove reference to antlrcpp:s2ws (#3656) by @​jcking in antlr/antlr4#3657
• Update publishing instruction for Dart by @​lingyv-li in antlr/antlr4#3655
• Prep 4.10.1 by @​parrt in antlr/antlr4#3660

Full Changelog: antlr/antlr4@v4.10.0...4.10.1

4.10 Major feature, code clean up, and bug fix release

ANTLR version 4.10

This is a very major release with a number of important changes. There have been many valuable contributions, but I welcome @​KvanTTT and @​jcking as recent "official" major ANTLR contributors. :)

WARNING: Generated 4.10 lexers and parsers are incompatible with code generated by previous versions of ANTLR. You must regenerate all of your code from grammars to use the new runtime. This is true of all targets (except probably javascript).

Repo branching structure

We have changed the branching structure of the repository. The default branch for this repo remains master and it is the latest stable release with tags for the various releases; e.g., see release tag 4.9.3. We now do development work in branch dev between releases and all pull requests should be derived from that branch. The dev branch is merged back into master to cut a release and the release state is tagged (e.g., with 4.10-rc.1 or 4.10.) Visually our process looks roughly like this:

Targets such as Go that pull directly from the repository can use the default master branch but can also pull from the active dev branch:

$ go get github.com/antlr/antlr4/runtime/Go/antlr@dev

Developers certificate of origin

In order to bring ANTLR more in line with current standard standards for contribution processes, as of 4.10, ANTLR uses the Linux Foundation's Developer Certificate of Origin, DCO, version 1.1. See file https://github.com/antlr/antlr4/raw/master/developer-cert-of-origin.txt . It is simpler than the original contributors license agreement, which required programmers to sign the contributors.txt file, which has now moved to file historical-contributors-agreement.txt .

Each commit in pull requests must have a "signature", which is simple as using -s (not -S) on the git commit command:

$ git commit -s -m 'This is my commit message'

Github's pull request process enforces the sig and gives instructions on how to fix any commits that lack the sig. See https://github.com/apps/dco for more info.

4.10-generated parsers incompatible with previous runtimes

ANTLR not only generates recursive-descent parsers; it generates a state machine called an augmented transition network (ATN) in serialized form as a bunch of integers stored in the generated parser and lexer files. This serialization format was changed for 4.10 to remove a size limit on the supported ATNs. See antlr/antlr4#3591.

The key point here is that we changed the version number stored inside the serialization format and so, in order to use this new version of ANTLR, you must regenerate all of your lexers and parsers using the 4.10 tool and then use the new runtime. Parsers generated with 4.10 or not compatible with previous versions of the runtime.

Increasing minimum java version

... (truncated)

• 44d87bc [maven-release-plugin] prepare release 4.10.1
• 03c47f7 Prep 4.10.1 (#3660)
• f6b2022 update instruction for dart (#3655)
• 3724b19 [C++] Remove reference to antlrcpp:s2ws (#3656) (#3657)
• ae1bf40 use to 4.3.3 ST4 not snapshot
• 3adf4fd use to 4.3.3 ST4, tweak status badge
• 3e3fecf fix badges
• 661d8ec deploy script copied wrong jar file
• e37fea1 tweak doc, scripts for release
• 2471728 [maven-release-plugin] prepare for next development iteration
• Additional commits viewable in compare view

Sourced from antlr4-maven-plugin's releases.

4.10.1

Tiny update to fix build issue where java requirement for runtime was 11 not 1.8.

What's Changed

• [C++] Remove reference to antlrcpp:s2ws (#3656) by @​jcking in antlr/antlr4#3657
• Update publishing instruction for Dart by @​lingyv-li in antlr/antlr4#3655
• Prep 4.10.1 by @​parrt in antlr/antlr4#3660

Full Changelog: antlr/antlr4@v4.10.0...4.10.1

4.10 Major feature, code clean up, and bug fix release

ANTLR version 4.10

This is a very major release with a number of important changes. There have been many valuable contributions, but I welcome @​KvanTTT and @​jcking as recent "official" major ANTLR contributors. :)

WARNING: Generated 4.10 lexers and parsers are incompatible with code generated by previous versions of ANTLR. You must regenerate all of your code from grammars to use the new runtime. This is true of all targets (except probably javascript).

Repo branching structure

We have changed the branching structure of the repository. The default branch for this repo remains master and it is the latest stable release with tags for the various releases; e.g., see release tag 4.9.3. We now do development work in branch dev between releases and all pull requests should be derived from that branch. The dev branch is merged back into master to cut a release and the release state is tagged (e.g., with 4.10-rc.1 or 4.10.) Visually our process looks roughly like this:

Targets such as Go that pull directly from the repository can use the default master branch but can also pull from the active dev branch:

$ go get github.com/antlr/antlr4/runtime/Go/antlr@dev

Developers certificate of origin

In order to bring ANTLR more in line with current standard standards for contribution processes, as of 4.10, ANTLR uses the Linux Foundation's Developer Certificate of Origin, DCO, version 1.1. See file https://github.com/antlr/antlr4/raw/master/developer-cert-of-origin.txt . It is simpler than the original contributors license agreement, which required programmers to sign the contributors.txt file, which has now moved to file historical-contributors-agreement.txt .

Each commit in pull requests must have a "signature", which is simple as using -s (not -S) on the git commit command:

$ git commit -s -m 'This is my commit message'

Github's pull request process enforces the sig and gives instructions on how to fix any commits that lack the sig. See https://github.com/apps/dco for more info.

4.10-generated parsers incompatible with previous runtimes

ANTLR not only generates recursive-descent parsers; it generates a state machine called an augmented transition network (ATN) in serialized form as a bunch of integers stored in the generated parser and lexer files. This serialization format was changed for 4.10 to remove a size limit on the supported ATNs. See antlr/antlr4#3591.

The key point here is that we changed the version number stored inside the serialization format and so, in order to use this new version of ANTLR, you must regenerate all of your lexers and parsers using the 4.10 tool and then use the new runtime. Parsers generated with 4.10 or not compatible with previous versions of the runtime.

Increasing minimum java version

... (truncated)

• 44d87bc [maven-release-plugin] prepare release 4.10.1
• 03c47f7 Prep 4.10.1 (#3660)
• f6b2022 update instruction for dart (#3655)
• 3724b19 [C++] Remove reference to antlrcpp:s2ws (#3656) (#3657)
• ae1bf40 use to 4.3.3 ST4 not snapshot
• 3adf4fd use to 4.3.3 ST4, tweak status badge
• 3e3fecf fix badges
• 661d8ec deploy script copied wrong jar file
• e37fea1 tweak doc, scripts for release
• 2471728 [maven-release-plugin] prepare for next development iteration
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)