Prep 4.10 (#3599)

* Tweak doc

* Swift was referring to hardcoded version

* Start version update script.

* add files to update

* clean up setup

* clean up setup

* clean up setup

* don't need file

* don't need file

* Fixes #3600.  add instructions and associated code necessary to build the xpath lexers.

* clean up version nums

* php8

* php8

* php8

* php8

* php8

* php8

* php8

* php8

* tweak doc

* ok, i give up. php won't  bump up too v8

* tweak doc

* version number bumped to 4.10 in runtime.

* Change the doc for releasing and update to use latest ST 4.3.2

* fix dart version to 4.10.0

* cmd files Cannot use export bash command.

* try fixing php ci again

* working on deploy

Signed-off-by: Terence Parr <[email protected]>

* php8 always install.

* set js to 4.10.0 not 4.10

* turn off apt update for php circleci

* try w/o cimg/php

* try setting branch

* ok i give up

* tweak

* update docs for release.

* php8 circleci

* use 3.5.3 antlr

* use 3.5.3-SNAPSHOT antlr

Author: parrt

.circleci/scripts/install-linux-php.sh

@@ -2,15 +2,19 @@
 
 set -euo pipefail
 
-sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
-sudo apt-get update -qq
-
+sudo apt install software-properties-common
+sudo add-apt-repository ppa:ondrej/php
 sudo apt update
 
-sudo apt install php-all-dev
+sudo apt install wget php8.0-cli php8.0-zip unzip
+wget -O composer-setup.php https://getcomposer.org/installer
+sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
+
+sudo apt install php8.0
+sudo apt install php8.0-mbstring
+sudo apt install php8.0-xml
 php -v
 
-sudo apt install composer
 
 git clone https://github.com/antlr/antlr-php-runtime.git runtime/PHP
 composer install -d runtime/PHP

.github/scripts-windows/run-tests-csharp.cmd

@@ -1,6 +1,5 @@
 dotnet build runtime/CSharp/src/Antlr4.csproj -c Release
 dotnet pack runtime/CSharp/src/Antlr4.csproj -c Release
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dtest=csharp.** test
 cd ..

.github/scripts-windows/run-tests-dart.cmd

@@ -1,6 +1,5 @@
 C:\ProgramData\chocolatey\bin\choco.exe -y install dart-sdk
 
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dtest=dart.** test -Dantlr-dart-dart="C:\tools\dart-sdk\bin\dart.exe" -Dantlr-dart-pub="C:\tools\dart-sdk\bin\pub.bat" -Dantlr-dart-dart2native="C:\tools\dart-sdk\bin\dart2native.bat"
 cd ..

.github/scripts-windows/run-tests-go.cmd

@@ -1,4 +1,3 @@
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dtest=go.** test
 cd ..

.github/scripts-windows/run-tests-java.cmd

@@ -1,4 +1,3 @@
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dtest=java.** test
 cd ..

.github/scripts-windows/run-tests-javascript.cmd

@@ -1,4 +1,3 @@
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dtest=javascript.** test
 cd ..

.github/scripts-windows/run-tests-php.cmd

@@ -1,9 +1,8 @@
 REM C:\ProgramData\chocolatey\bin\choco.exe install php -y --package-parameters='"/DontAddToPath"'
 
-git clone https://github.com/antlr/antlr-php-runtime/tree/dev
+git clone https://github.com/antlr/antlr-php-runtime.git
 move antlr-php-runtime runtime\PHP
 
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dtest=php.** test -Dantlr-php-php="C:\tools\php81\php.exe"
 cd ..

.github/scripts-windows/run-tests-python2.cmd

@@ -1,4 +1,3 @@
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dantlr-python2-python="C:\Python27\python.exe" -Dtest=python2.** test
 cd ..

.github/scripts-windows/run-tests-python3.cmd

@@ -1,4 +1,3 @@
 cd runtime-testsuite
-export MAVEN_OPTS="-Xmx8g"
 mvn -Dparallel=classes -DthreadCount=2 -Dantlr-python3-python="C:\Python310\python.exe" -Dtest=python3.** test
 cd ..

CONTRIBUTING.md

@@ -2,11 +2,22 @@
 
 1. [Fork](https://help.github.com/articles/fork-a-repo) the [antlr/antlr4 repo](https://github.com/antlr/antlr4), which will give you both key branches, `master` and `dev`
 2. Make sure to `git checkout dev` in your fork so that you are working from the latest development branch
-2. Install and configure [EditorConfig](http://editorconfig.org/) so your text editor or IDE uses the ANTLR 4 coding style
-3. [Build ANTLR 4](doc/building-antlr.md)
-4. [Run the ANTLR project unit tests](doc/antlr-project-testing.md)
-5. Create a [pull request](https://help.github.com/articles/using-pull-requests/) with your changes and make sure you're comparing the `dev` branch in your fork to the `dev` branch from the `antlr/antlr4` repo:
+3. Create and work from a branch from `dev` such as `git checkout -b 
+   your-branch-name`
+4. Install and configure [EditorConfig](http://editorconfig.org/) so your text editor or IDE uses the ANTLR 4 coding style
+5. [Build ANTLR 4](doc/building-antlr.md)
+6. [Run the ANTLR project unit tests](doc/antlr-project-testing.md)
+7. Create a [pull request](https://help.github.com/articles/using-pull-requests/) with your changes and make sure you're comparing the `dev` branch in your fork to the `dev` branch from the `antlr/antlr4` repo:
 
 <img src="doc/images/PR-on-dev.png" width="600">
 
-**Note:** You must sign the `contributors.txt` certificate of origin with your pull request if you've not done so before.
+**Note:** Each commit requires a "signature", which is simple as using `-s` (not 
+`-S`) to 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 [Github DCO app](https://github.com/apps/dco) 
+for more info.