Provide java port

[nick-stephen]

I got the OK to contribute the port.

No examples yet other than unit tests.

Very simple readme.md

Please let me know if you'd like something changed / improved before merge.

If you're OK with the suggestion I propose using this to release a jar of the library to maven central under com.vmware.antlr4c3 antlr4-c3-.jar - this is since I did this on vmware time.

I also suggest that the version numbers of java and javascript don't try to be aligned so that they can be released separately, in which case the java version might release with version 1.0.0 initially, otherwise I'd be fine aligning them starting with 1.1.5 (but the codebases aren't 100% identical and maybe one will add things the other won't have or not straight away anyway, so the versions will drift...

Thx

Nick

[mike-lischke]

Looks good. No intention to provide a port of the symbol table? It's not mandatory (we could use antlr's symtab instead), just asking.

[mike-lischke]

I'm fine with releasing a jar on maven central, though I have no idea how to do that. And I guess it doesn't matter if both version numbers are in sync.

[nick-stephen]

Hi Mike, I wasn’t intending on porting the symbol table, as I’m not using it at all.. however I was thinking of contributing a small wrapper which pre-tokenizes the input to look for the last symbol’s offset (and removes any unparsed characters from the input), and which creates an output which is in textual form with the rule or token type, its text, and information about the context (the encountered preferred rules and the text of their last occurrence. The pre-tokenizing helps automate the section you describe as ‘Selecting the Right Caret Position’. I also encountered situations where the text didn’t completely tokenize because of a half-finished token, which I dealt with too in the wrapper. Nick On 27/08/2017, 11:05, "Mike Lischke" <notifications@github.com<mailto:notifications@github.com>> wrote: @mike-lischke approved this pull request. Looks good. No intention to provide a port of the symbol table? It's not mandatory (we could use antlr's symtab instead), just asking. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_mike-2Dlischke_antlr4-2Dc3_pull_8-23pullrequestreview-2D58817673&d=DwMCaQ&c=uilaK90D4TOVoH58JNXRgQ&r=nrb6BBcaYzei5VLTFeRqBQ&m=D13_5kx6cOYWAL_K2N08UrrjEi2C1GEjhPuR-i7JnOM&s=leMLjzecWRf_QB35HVvykoeKvcv5QmiOmbYGjy1yHM0&e=>, or mute the thread<https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_notifications_unsubscribe-2Dauth_AZZ37UAuy6KUtq7rBS-2DG2OIKoQnUn4O9ks5scTFigaJpZM4PDvGz&d=DwMCaQ&c=uilaK90D4TOVoH58JNXRgQ&r=nrb6BBcaYzei5VLTFeRqBQ&m=D13_5kx6cOYWAL_K2N08UrrjEi2C1GEjhPuR-i7JnOM&s=0m11GV_BS0cpJNJuB0AQs8O3c5DQ5n7j_RLczm8t2MA&e=>.

[mike-lischke]

Understandable. As I said, it's not mandatory to have a symbol table in the port. I'm glad about any further contribution you might have!

However, one thing we need to do yet: please sign the (new) contributors.txt list (in the root of the repo). This is essential to fully accept your contribution. Thanks.