antlr/README.md

# ANTLR v4

**ANTLR** (ANother Tool for Language Recognition) is a powerful parser generator for reading, processing, executing, or translating structured text or binary files. It's widely used to build languages, tools, and frameworks. From a grammar, ANTLR generates a parser that can build parse trees and also generates a listener interface (or visitor) that makes it easy to respond to the recognition of phrases of interest.

* [Wikipedia](https://en.wikipedia.org/wiki/ANTLR)
* [Official site](http://www.antlr.org/)
* [Documentation](https://theantlrguy.atlassian.net/wiki/display/ANTLR4/ANTLR+4+Documentation)
* [FAQ](https://theantlrguy.atlassian.net/wiki/display/ANTLR4/ANTLR+v4+FAQ)
* [API](http://www.antlr.org/api/Java/index.html)
* [ANTLR v3](http://www.antlr3.org/)
* [v3 to v4 Migration guide, differences](https://theantlrguy.atlassian.net/wiki/pages/viewpage.action?pageId=1900596)

[Release notes](https://github.com/antlr/antlr4/releases)

*For installation and other getting started information, see [Getting started with v4](https://theantlrguy.atlassian.net/wiki/display/ANTLR4/Getting+Started+with+ANTLR+v4).*

## The Definitive ANTLR 4 Reference
You can buy a book [The Definitive ANTLR 4 Reference](http://pragprog.com/book/tpantlr2/the-definitive-antlr-4-reference)

Programmers run into parsing problems all the time. Whether it’s a data format like JSON, a network protocol like SMTP, a server configuration file for Apache, a PostScript/PDF file, or a simple spreadsheet macro language—ANTLR v4 and this book will demystify the process. ANTLR v4 has been rewritten from scratch to make it easier than ever to build parsers and the language applications built on top. This completely rewritten new edition of the bestselling Definitive ANTLR Reference shows you how to take advantage of these new features.

[Book source code](http://pragprog.com/titles/tpantlr2/source_code)

## Additional grammars
[This repository](https://github.com/antlr/grammars-v4) is a collection of grammars without actions where the
root directory name is the all-lowercase name of the language parsed
by the grammar. For example, java, cpp, csharp, c, etc...

## Authors and major contributors

[Terence Parr](http://www.cs.usfca.edu/~parrt/), parrt@cs.usfca.edu
ANTLR project lead and supreme dictator for life
[University of San Francisco](http://www.usfca.edu/)

[Sam Harwell](http://tunnelvisionlabs.com/)

Eric Vergnaud (Python2, Python3 targets)
-												Update README.md
											
										
										
											2013-12-23 12:44:16 +08:00
+								# ANTLR v4
-												add README

											
										
										
											2012-02-01 11:28:15 +08:00
-												update for 4.2.1

											
										
										
											2014-03-26 00:46:58 +08:00
+								**ANTLR** (ANother Tool for Language Recognition) is a powerful parser generator for reading, processing, executing, or translating structured text or binary files. It's widely used to build languages, tools, and frameworks. From a grammar, ANTLR generates a parser that can build parse trees and also generates a listener interface (or visitor) that makes it easy to respond to the recognition of phrases of interest.
-												add README

											
										
										
											2012-02-01 11:28:15 +08:00
-												Update README.md
											
										
										
											2013-12-23 12:46:35 +08:00
+								* [Wikipedia](https://en.wikipedia.org/wiki/ANTLR)
-												update readme

											
										
										
											2013-12-31 03:47:47 +08:00
+								* [Official site](http://www.antlr.org/)
-												update for 4.2.1

											
										
										
											2014-03-26 00:46:58 +08:00
+								* [Documentation](https://theantlrguy.atlassian.net/wiki/display/ANTLR4/ANTLR+4+Documentation)
 								* [FAQ](https://theantlrguy.atlassian.net/wiki/display/ANTLR4/ANTLR+v4+FAQ)
 								* [API](http://www.antlr.org/api/Java/index.html)
-												Update README.md
											
										
										
											2013-12-23 12:46:35 +08:00
+								* [ANTLR v3](http://www.antlr3.org/)
-												Update README.md
											
										
										
											2014-02-19 04:23:42 +08:00
+								* [v3 to v4 Migration guide, differences](https://theantlrguy.atlassian.net/wiki/pages/viewpage.action?pageId=1900596)
-												Update README.md
											
										
										
											2013-12-23 12:44:16 +08:00
-												add link to the releases

											
										
										
											2014-03-26 00:48:43 +08:00
+								[Release notes](https://github.com/antlr/antlr4/releases)
-												I have removed all of the installation and getting started stuff from the readme and pointed them to the wiki which is easier to update.

											
										
										
											2014-06-11 03:57:39 +08:00
+								*For installation and other getting started information, see [Getting started with v4](https://theantlrguy.atlassian.net/wiki/display/ANTLR4/Getting+Started+with+ANTLR+v4).*
-												Update README.md
											
										
										
											2013-12-23 12:44:16 +08:00
 								## The Definitive ANTLR 4 Reference
-												fixed some typos in the README

											
										
										
											2014-01-07 20:24:38 +08:00
+								You can buy a book [The Definitive ANTLR 4 Reference](http://pragprog.com/book/tpantlr2/the-definitive-antlr-4-reference)
-												Update README.md
											
										
										
											2013-12-23 12:47:53 +08:00
-												Update README.md
											
										
										
											2013-12-23 12:44:16 +08:00
+								Programmers run into parsing problems all the time. Whether it’s a data format like JSON, a network protocol like SMTP, a server configuration file for Apache, a PostScript/PDF file, or a simple spreadsheet macro language—ANTLR v4 and this book will demystify the process. ANTLR v4 has been rewritten from scratch to make it easier than ever to build parsers and the language applications built on top. This completely rewritten new edition of the bestselling Definitive ANTLR Reference shows you how to take advantage of these new features.
 								[Book source code](http://pragprog.com/titles/tpantlr2/source_code)
-												 Added some documentation, change the version number on v3 lib. Added Sam to the license.

											
										
										
											2012-09-19 02:25:06 +08:00
-												fixed some typos in the README

											
										
										
											2014-01-07 20:24:38 +08:00
+								## Additional grammars
-												Update README.md
											
										
										
											2013-12-23 12:44:16 +08:00
+								[This repository](https://github.com/antlr/grammars-v4) is a collection of grammars without actions where the
 								root directory name is the all-lowercase name of the language parsed
 								by the grammar. For example, java, cpp, csharp, c, etc...
-												 Added some documentation, change the version number on v3 lib. Added Sam to the license.

											
										
										
											2012-09-19 02:25:06 +08:00
-												add title to javadoc, tweak readme stuff.

											
										
										
											2014-07-17 05:08:31 +08:00
+								## Authors and major contributors
-												 Added some documentation, change the version number on v3 lib. Added Sam to the license.

											
										
										
											2012-09-19 02:25:06 +08:00
-												add title to javadoc, tweak readme stuff.

											
										
										
											2014-07-17 05:08:31 +08:00
+								[Terence Parr](http://www.cs.usfca.edu/~parrt/), parrt@cs.usfca.edu
-												update for 4.2.1

											
										
										
											2014-03-26 00:46:58 +08:00
+								ANTLR project lead and supreme dictator for life
-												Update README.md
											
										
										
											2013-12-23 12:44:16 +08:00
+								[University of San Francisco](http://www.usfca.edu/)
-												update readme

											
										
										
											2013-12-31 03:47:47 +08:00
 								[Sam Harwell](http://tunnelvisionlabs.com/)
-												add title to javadoc, tweak readme stuff.

											
										
										
											2014-07-17 05:08:31 +08:00
 								Eric Vergnaud (Python2, Python3 targets)