Commit Graph

330 Commits

Author SHA1 Message Date
Erik A. Brandstadmoen 85154d06ee Changed incorrect .js file endings to .cs in doc/charp-target.md 2017-06-11 23:43:39 +02:00
Corey Kosak 1bb3eb1ebf Fix listener example in C++ documentation.
The listener example still refers to Ref<> and shared pointers, but in
reality the generated method does not pass a shared pointer. The actual
signature looks more like this:

  virtual void enterKey(ParserRuleContext * /*ctx*/) override { }

This change updates the example to match that signature, and removes a line
discussing Ref<>. It also adds the "override" keyword in order to make the
user's code a little more robust against typos/changes in the grammar.
2017-06-01 11:15:48 -04:00
Terence Parr c97abe5bc2 Merge pull request #1831 from mike-lischke/issue1824
Update C++ target doc for latest API changes - fixes #1824.
2017-05-31 10:16:36 -07:00
Will Fuqua e39543a257 add build script and update docs 2017-05-27 00:02:54 +07:00
David Sisson f41ce7fed4 Fix tests for PR #1844. 2017-04-29 17:27:08 -07:00
parrt 8c05696ed4 update js doc 2017-04-26 09:56:31 -07:00
Mike Lischke 3f7c67106b Interpreter is now always generated. Doc updated. 2017-04-21 17:15:51 +02:00
Mike Lischke 1fdb7cd31d Update C++ target doc for latest API changes - fixes #1824. 2017-04-19 14:23:44 +02:00
Terence Parr 2f248353a3 Merge pull request #1819 from bradh/patch-1
Update getting-started.md (trivial)
2017-04-17 09:57:24 -07:00
lys0716 b8e81d5814 Correct typo in lexicon.md
’\’' should be ’\’

Signed-off-by: Yishuang Lu <luyscmu@gmail.com>
2017-04-12 16:50:09 -07:00
Brad Hards 8a9f259f62 Update getting-started.md
Either that or say what is is useful to do with...
2017-04-09 15:16:26 +10:00
parrt 8af0080103 add link 2017-04-03 09:56:07 -07:00
parrt c8d9749be1 update doc on cutting release to 4.7 2017-03-30 14:36:04 -07:00
parrt e95b74842e update npm doc in releasing doc 2017-03-30 11:12:58 -07:00
parrt 2ab9c8ab51 add note about utf-16 code units in grammars. Fixes #1802 2017-03-30 10:54:58 -07:00
parrt 04507895bd add link to Unicode doc 2017-03-30 09:49:45 -07:00
parrt bb33217d14 add Ben to readme 2017-03-30 09:47:06 -07:00
parrt ad3b43459d rm new 2017-03-29 15:04:19 -07:00
parrt 40e1072e7e update target docs that need alteration for new interface 2017-03-29 14:59:14 -07:00
parrt 039f43999c tweak documentation about various targets 2017-03-29 14:46:50 -07:00
parrt a7b2f3f12d more tweaks about the status of UTF-8 in previous and current defaults. 2017-03-29 14:26:36 -07:00
parrt cd2b6936cf fix another reference to previous streams 2017-03-29 14:21:16 -07:00
parrt 6dd9a3fbe3 respond to @bhamiltoncx comments 2017-03-29 14:19:37 -07:00
parrt 1fcb5951c6 change the example to use the new stream interface 2017-03-29 14:14:32 -07:00
parrt c3ed9a992d Add more about unbuffered streams. tweak style of code 2017-03-29 13:56:57 -07:00
parrt 496f9c398d update unicode doc, code comments 2017-03-29 13:29:23 -07:00
parrt e0ea43ccb8 fix antlr notation 2017-03-20 14:48:00 -07:00
Mike Lischke 54601f7128 A few updates to the Unicode documentation.
It should be made clear that the recommended use of CharStreams.fromPath() is a Java-only solution. The other targets just have their ANTLRInputStream class extended to support full Unicode.
2017-03-18 13:01:11 +01:00
Terence Parr 1f6a329692 Merge pull request #1765 from bhamiltoncx/unicode-cleanup-and-doc
Tidy up CharStreams and add new doc/unicode.md
2017-03-16 17:03:06 -07:00
Ben Hamilton 4f2168600d Tidy up CharStreams API. Add new doc/unicode.md 2017-03-16 17:01:46 -06:00
Ben Hamilton c71b7d2f18 EmojiDefault and TextDefault 2017-03-14 13:27:01 -06:00
parrt b467dc8015 remove outdated testing document, small update regarding API testing 2017-03-14 11:33:19 -07:00
parrt 98f1d808c6 update doc 2017-03-09 09:54:06 -08:00
Ben Hamilton 6007132e2e Also support Unicode enumerated properties via \p{East_Asian_Width=Ambiguous} escape 2017-03-08 09:43:50 -08:00
Ben Hamilton c209f2a51e Update docs for new Unicode literal and property escapes 2017-03-02 09:36:18 -08:00
Ben Hamilton 242eb44cd0 Move doc/contributing.md to /CONTRIBUTING.md 2017-01-24 10:43:01 -08:00
Ben Hamilton 379013bf35 New doc 'Contributing to ANTLR' 2017-01-24 10:10:26 -08:00
Terence Parr 75784e0b8f update file list needed version bump 2016-12-28 12:02:55 -08:00
Terence Parr 64fd96d045 Update releasing-antlr.md 2016-12-28 11:54:27 -08:00
Mike Lischke 4458950fd8 Re-added changed exportMacro documentation (got lost on revert). 2016-12-19 18:10:39 +01:00
Mike Lischke a9dc3ebd86 Merge branch 'master_upstream' 2016-12-19 16:47:39 +01:00
Eric Vergnaud a87df6f28a more js docs 2016-12-17 00:23:16 +08:00
Eric Vergnaud 14f0c7a663 also published to npm 2016-12-17 00:03:03 +08:00
parrt c4c2966dbd update doc 2016-12-15 20:42:29 -08:00
parrt b94ecc0fa5 update doc for new C# build 2016-12-15 14:58:52 -08:00
Terence Parr d388e6b867 Merge pull request #1522 from parrt/ericvergnaud-publish-to-nuget
Ericvergnaud publish to nuget
2016-12-15 13:32:21 -08:00
parrt 31726311a8 add exportMacro to list of valid grammar options. verified it works in grammar and -D on command line. 2016-12-15 13:25:02 -08:00
Mike Lischke d1b429d94c Added a new setting required by the C++ runtime.
In order to export generated classes in DLLs we need a way to specify the __declspec setting. This is is usually done via a macro that takes the import or export value. The new parameter (`-export-macro`) allows to specify this, which increases the flexibility of the generated classes.

The C++ target documentation has been extended to describe build specific things, includig this new parameter.
2016-12-15 13:11:10 -08:00
parrt 0c332f704c tweak to doc 2016-12-15 13:04:59 -08:00
parrt 7f95781321 update doc with more detail on building c# 2016-12-15 12:44:44 -08:00
parrt 586b36fe94 tweak doc. update assembly name to Antlr4.Runtime.Standard 2016-12-15 12:28:32 -08:00
parrt 3c1a34d005 add this to 'building a release doc' 2016-12-15 12:21:36 -08:00
Eric Vergnaud c78d42657e added link to the C# page 2016-12-15 12:01:10 -08:00
Mike Lischke 428ff28f35 Added a new setting required by the C++ runtime.
In order to export generated classes in DLLs we need a way to specify the __declspec setting. This is is usually done via a macro that takes the import or export value. The new parameter (`-export-macro`) allows to specify this, which increases the flexibility of the generated classes.

The C++ target documentation has been extended to describe build specific things, includig this new parameter.
2016-12-15 16:44:26 +01:00
hanjoes 12744d40ad Update swift-target.md 2016-12-14 23:13:37 -08:00
Hanzhou Shi 03709dc879 Tweak picture size. 2016-12-14 23:11:18 -08:00
Hanzhou Shi c7e291e77b Tweak Swift target doc. 2016-12-14 22:53:34 -08:00
Hanzhou Shi bf37edf039 Tweak Swift target doc. 2016-12-14 22:50:53 -08:00
hanjoes 86ea75dcea More doc for Swift target. 2016-12-14 22:30:26 -08:00
parrt 81cb4367bb tweak doc 2016-12-14 16:41:19 -08:00
Terence Parr 3db68a7ea0 Merge pull request #1513 from ericvergnaud/typos
Added Go in features table, and keep target order in sync with above.
2016-12-14 13:22:51 -08:00
parrt 5cc106562f update doc 2016-12-14 12:52:05 -08:00
parrt 7430b74d98 update doc; move testing info to single file. rename doc file. 2016-12-14 11:51:28 -08:00
Eric Vergnaud 30acda080d Added Go, and keep target order in sync with above. 2016-12-15 03:18:43 +08:00
parrt f83d03a93e improve doc 2016-12-14 10:28:14 -08:00
parrt caa500094f tweak docs to show 4.6 2016-12-13 13:36:19 -08:00
Terence Parr e1a330f540 Update releasing-antlr.md 2016-12-13 13:24:45 -08:00
Mike Lischke 31b259e636 Merge branch 'master_upstream' 2016-12-13 09:00:13 +01:00
parrt aa5f782bdb update doc 2016-12-11 09:48:24 -08:00
Mike Lischke 4aaa0bfb5a Better synchronization for multithreading - fixes issue #1435
- The shared mutexes were defined as normal instance variables in a simulator, so the locks didn't work (multiple instances of simulators active). By making them static (which is more appropriate anyway, since we are protecting static data) the synchroniation now works.
- For better performance an own class for multiple read/single write locks was added and used instead of the shared mutexes.
- Made the static wstring_covvert instance local variables in ws2s and s2ws. Otherwise we would also need a mutext to protect it.

- Some other minor changes.
2016-12-11 12:53:24 +01:00
Ewan Mellor b0c3824357 Create a new Xcode playground for Swift.
This takes the example from
https://github.com/janyou/Antlr-Swift-Runtime/tree/master/Test and packages
it into an Xcode playground.  This allows the user to interact with the
grammar directly inside Xcode, and serves as a live demo of the Swift support.

Update the docs to match.
2016-12-01 01:23:52 -08:00
Oliver Sampson b4bf40e47e Update getting-started.md 2016-11-25 15:52:18 +01:00
Oliver Sampson 3ed4348ab6 Update getting-started.md 2016-11-25 13:01:24 +01:00
janyou a74b33339c update swift-target.md 2016-11-23 07:00:17 +08:00
parrt 10fb0a3049 add info on Swift target 2016-11-22 12:11:13 -08:00
parrt 39ddd0da3a improve doc on build 2016-11-21 11:44:16 -08:00
parrt 06285d16d7 improve doc on runtime targets 2016-11-21 10:51:07 -08:00
Terence Parr f72fe32e8c Merge pull request #1228 from tobiasbueschel/patch-1
correct spelling error
2016-11-19 14:35:37 -08:00
parrt 79dbb8be96 small improvements to locating mono, node 2016-11-19 14:05:43 -08:00
parrt 978851f703 update doc 2016-11-19 13:14:29 -08:00
parrt 201925b2da tweak doc 2016-11-19 12:57:07 -08:00
parrt 0dcf626e8b tweak doc 2016-11-19 11:59:08 -08:00
parrt 19d956cfc2 tweak doc 2016-11-19 11:53:53 -08:00
parrt a736e4b9ee tweak doc 2016-11-19 11:15:31 -08:00
parrt a6a730405f finish binary example and update documentation 2016-11-18 09:07:40 -08:00
parrt c8cb2fde73 add binary test case 2016-11-17 14:56:53 -08:00
parrt b4d8982e95 Merge branch 'master' of git://github.com/NoodleOfDeath/antlr4 2016-11-17 10:31:43 -08:00
parrt 9675c822a9 update doc, add lock so antlr used atomically in unit tests so we can run in parallel. 2016-11-16 15:42:45 -08:00
parrt 5aae2edb24 support x:T notation in rule arguments, update documentation, improve [...] scope parsing testing 2016-11-16 11:54:23 -08:00
parrt d534efdf9a update doc on the runtime test mechanism. change the name of BaseDebugParserTestDescriptor to BaseDiagnosticParserTestDescriptor. 2016-11-15 14:25:28 -08:00
Terence Parr 29fa9ba36e Merge pull request #1344 from pboyer/patch-4
Update Go documentation
2016-11-07 23:25:50 +01:00
parrt 061177fab0 tweak doc 2016-11-07 14:15:15 -08:00
Peter Boyer 893ecf981b Update Go documentation 2016-11-07 12:11:24 -05:00
Mike Lischke 3b3fe3da57 Merge branch 'master_upstream'
Had to resolve a number of conflicts + added code required for the C++ target to generate header files, after the recent changes in the main repo.
2016-11-07 11:16:02 +01:00
Thom Morgan 0c6ee8fa62 Update actions.md 2016-11-06 09:41:26 -05:00
parrt bcfa70c4e8 test templates were missing visitor-related templates. slight improvement to test generator. 2016-11-05 16:26:01 -07:00
parrt 803e72ba38 tweak 2016-11-05 15:22:55 -07:00
parrt cbbdbaac75 add Go target links in doc 2016-11-05 15:15:22 -07:00
Peter Boyer fc35818c52 Update import statements after merge 2016-11-05 16:36:53 -04:00
Peter Boyer 7eb6aec612 Add runtime 2016-11-05 12:25:15 -04:00
Peter Boyer 8b67d2418c Move go target docs 2016-11-04 14:36:02 -04:00
Mike Lischke 8280beb564 Refactoring of further int values, mostly converting them to size_t.
- Switched most symbolic signed constants to unsigned variants. Redefined EOF in particular to become (size)-1, to avoid having to use signed token type values.
- Introduced INVALID_INDEX for all previous -1 values to indicate e.g. not found indexes etc.
- Added 2 helpers to convert between symbolic and numeric form (mostly for intervals and toString()).
- Removed many no longer needed type casts to size_t.
- Updated templates for these changes.
- Limited runtime tests to C++ tests only, to see how Travis CI copes with that.
2016-10-02 16:51:57 +02:00
Mike Lischke 3b98c1136e Merge branch 'master_upstream' 2016-09-25 11:31:51 +02:00
parrt 0b2d5304a5 tweak links in doc 2016-09-24 11:20:13 -07:00
parrt 2f92b47500 tweak links in doc 2016-09-23 13:19:44 -07:00
Eric Vergnaud d3ceee5043 Enhancing the doc 2016-09-24 00:02:18 +08:00
Mike Lischke 7abfbc60c6 Change deployment scripts location and updated doc.
In order to be able to build with cmake and to have a complete source package including the demo the deployment scripts were moved to the root Cpp folder and updated.
Also the releasing-antlr.md doc file has been updated.
2016-08-04 17:03:34 +02:00
Tobias Büschel cf258582f2 correct spelling error 2016-07-08 12:16:04 -04:00
Mike Lischke f6515e5aaf A few adjustments in doc + runtime tests for the changed library name + input stream handling. 2016-06-21 17:25:39 +02:00
Mike Lischke d718fa9f44 Windows runtime deployment.
- Created deployment script for Windows + updated doc/releasing-antlr.md.
- Created projects for both VS2013 and VS2015 to be used by the deployment script.
- Fixed trouble with a bug in VS2015 where std::codecvt_utf8<char32_t> is not properly supported.
- Fixed a few #include paths + a number of warnings.
2016-06-21 10:51:31 +02:00
Mike Lischke 89442c6cb8 Changes for deployment.
- Settled on a final library name scheme: base part is "libantlr4-runtime" on MacOS + Linux. The extension determines the type (.a static lib, .dylib dynamic lib in MacOS, .so dynamic lib in Linux). No more mention of target language (cpp) or type (static) in the lib name. On Windows we omit the lib prefix, so the name becomes: antlr4-runtime.dll + antlr4-runtime.lib. We may later want to add version information there, but doing that automatically is difficult.
- Updated XCode project and CMakeLists.txt file for the new naming scheme.
- Added deployment scripts for source code (for Linux + iOS) and MacOS.
- Added C++ section in docs/releasing-antlr.md.
2016-06-19 15:31:09 +02:00
Mike Lischke 4a7ec859aa Simplified parse tree listener handling.
No need to use shared_ptr for management. Listeners are, like the other main classes (parser, lexer, input stream etc.) provided by the application and hence managed there.
2016-06-17 10:22:19 +02:00
Mike Lischke dd48c0fbd5 A few final touches to make runtime tests passing. 2016-06-16 11:20:42 +02:00
Mike Lischke b9c28d8c9c Signficantly simplified Token handling.
In order to lower the overhead when passing around Token instances via smart pointers and because the ownership is clear (token streams own them), these instances can be passed as raw pointers.
2016-06-13 13:12:02 +02:00
Mike Lischke ff129beadf Some smaller fixes for Windows. 2016-06-06 15:58:14 +02:00
Mike Lischke 73248ac2e3 Some changes in the C++ target doc + a some template fixes.
- Avoiding double semicolons is tricky with the kind of rule nesting. Previous changes for that caused the tests to break as there were semicolons missing then.
- VS complained about the shift code generated using 1L as base, which is signed. Changed that to 1ULL, which is what is actually intended.
- Reverted the change to avoid a warning in RuleSempredFunction() in Cpp.stg as the fix didn't work 100%. We need a different solution.
2016-06-05 14:35:11 +02:00
Mike Lischke d6339f5cf4 Added some notes about Unicode to the C++ target doc. 2016-06-04 16:46:09 +02:00
Mike Lischke 80ced92d55 Added informations about C++ target specific stuff to the docs. 2016-06-04 15:28:04 +02:00
Mike Lischke 4a6b68c6f6 All C++ runtime tests pass now.
- A few remaining changes had to be done for the C++ runtime tests which now completely pass.
- Added a runtime testing overview document.
- Added a description of C++ target.
- Updated the ANTLR release document.
2016-06-04 12:11:38 +02:00
David Sisson b69076ab7f update docs 2016-05-05 21:58:59 -07:00
David Sisson 6c08a6e72d update docs 2016-05-05 21:58:05 -07:00
Terence Parr 14f05bbcc6 Update releasing-antlr.md 2016-03-30 16:59:48 -07:00
Terence Parr b9ed52ecd9 Update releasing-antlr.md 2016-03-30 16:51:40 -07:00
parrt 91560f7035 tweak doc 2016-03-30 16:06:11 -07:00
Terence Parr 20ad4bce7d Merge pull request #1127 from gagern/patch-1
Format feature parity table as markdown table
2016-03-29 22:11:09 +00:00
parrt 41a196082d Merge branch 'master' of github.com:antlr/antlr4 2016-03-29 14:40:17 -07:00
Terence Parr 65341a3020 Merge pull request #1116 from reitzig/patch-1
Fixes Markdown table in targets.md
2016-03-29 16:14:30 +00:00
parrt e4a4253219 more impl of get/set alt num; update doc 2016-03-28 14:10:29 -07:00
beardlybread ba64a1e001 documentation typos 2016-03-27 20:04:54 -04:00
Martin von Gagern eef470a707 Format feature parity table as markdown table 2016-03-07 12:14:37 +01:00
Raphael R 1fa0be9782 Fixes Markdown table in targets.md 2016-02-18 11:51:59 +01:00
Terence Parr a0204f25fd update doc 2016-01-30 09:58:06 -08:00
Terence Parr c92ddcbd06 update version to 4.5.2 in source / packaging stuff. 2016-01-30 09:54:47 -08:00
Terence Parr 2b9f5de4a9 Merge pull request #1090 from pboyer/patch-3
Minor cleanup to docs/ace-javascript-target.md
2016-01-28 11:11:45 -08:00
Terence Parr 9c6e212bc9 Update creating-a-language-target.md 2016-01-16 12:53:00 -08:00
Peter Boyer 6bb241952a Update ace-javascript-target.md 2016-01-03 21:18:32 -05:00
Peter Boyer cceda58ed6 One more 2016-01-03 21:18:09 -05:00
Peter Boyer c432ce8889 Update ace-javascript-target.md 2016-01-03 21:15:44 -05:00
sebadur a631e3007a Signed to contributors.txt
- Also implemented sharwell's suggested changes of originally pull request
2015-12-17 01:15:49 +01:00
Sebastian Badur 3876cc600a Fixing typos in listeners.md
- ParserRuleContext does not have type parameters
- Confusing sentence cleaned up a little
2015-12-16 20:45:44 +01:00
Terence Parr a072f59a87 Merge branch 'master' of github.com:antlr/antlr4 2015-12-08 11:34:45 -08:00
Terence Parr e7ba4967bc tweak doc 2015-11-26 11:04:58 -08:00
Udo Borkowski 0857dc40f3 Doc: more details on remotes `origin` and `upstream` in local Git repo 2015-11-25 00:32:56 +01:00
Terence Parr 8a4aa39de2 fix links 2015-11-23 16:19:45 -08:00
Terence Parr 292dce4f6d add more doc 2015-11-23 16:06:04 -08:00
Terence Parr 5aa8b29453 add more doc 2015-11-23 15:57:58 -08:00
Terence Parr e1073410f8 more doc 2015-11-22 09:25:41 -08:00
Terence Parr 1c3b4515ea add more doc 2015-11-19 15:59:04 -08:00
Terence Parr 73f042139c add more doc 2015-11-19 12:47:28 -08:00
Terence Parr 586bcd2368 Merge branch 'master' of github.com:parrt/antlr4 into move-doc-to-repo 2015-11-19 12:39:11 -08:00
Terence Parr 3fa8cfe29e add more doc 2015-11-19 12:34:04 -08:00
Terence Parr f6920d87ed add more doc 2015-11-15 17:47:49 -08:00
parrt fd2166984a add fuzzy doc 2015-11-04 17:22:26 -08:00
parrt 12e25a2ad7 add lexer rule doc 2015-11-04 16:51:42 -08:00
Terence Parr edc04740ba add more doc 2015-10-31 17:31:25 -07:00
Terence Parr a441b297af fix javadoc arg in pom, update javadoc instructions 2015-10-31 16:40:42 -07:00
Terence Parr fcffaca6bf fix index 2015-10-31 14:34:00 -07:00
Terence Parr 9b682b69b7 add to index 2015-10-31 14:30:36 -07:00
Terence Parr 3b00c09088 parser rules doc in 2015-10-31 14:28:59 -07:00
Terence Parr 1232e1bed1 table messed up 2015-10-31 13:54:24 -07:00
Terence Parr d6a075b843 mid-addition of parser rules 2015-10-31 13:51:09 -07:00
Terence Parr 147b7eb4ef fix grammars 2015-10-28 17:45:38 -07:00
Terence Parr 4d3e50844c fix grammars 2015-10-28 17:45:11 -07:00
Terence Parr 4aa9a6d237 add grammars 2015-10-28 17:43:18 -07:00
Terence Parr 2401e9688d add lexicon 2015-10-28 17:24:15 -07:00
Terence Parr b2db71a97e got doc in on adding tests 2015-10-28 17:06:40 -07:00
Terence Parr 7be6ff56a7 getting antlr build doc in 2015-10-28 16:03:49 -07:00
Terence Parr 8e286bb372 first doc commit 2015-10-27 17:36:22 -07:00
Terence Parr 66c0aeb93c first doc commit 2015-10-27 17:19:06 -07:00
Terence Parr 78fde76fc5 first doc commit 2015-10-27 17:12:01 -07:00
Terence Parr 85f453d419 finish adding the faq 2015-10-27 10:47:21 -07:00
Terence Parr 35dc46ef61 adding more faq 2015-10-27 10:47:21 -07:00
Terence Parr 35bf8c48af adding a few sample faq files 2015-10-27 10:47:21 -07:00
Terence Parr 25c8c8899c adding a few sample faq files 2015-10-27 10:47:21 -07:00
Terence Parr 52d45fe842 add index of faq 2015-10-27 10:47:21 -07:00
Terence Parr 7be5962948 finish adding the faq 2015-10-27 10:44:23 -07:00
Terence Parr 3e79f721fb adding more faq 2015-10-25 15:32:37 -07:00
Terence Parr c8e022f377 adding a few sample faq files 2015-10-25 15:23:01 -07:00
Terence Parr 77aa9ff173 adding a few sample faq files 2015-10-25 15:09:29 -07:00
Terence Parr 2e5cbc2e53 add index of faq 2015-10-25 14:04:14 -07:00