Updated How to build ANTLR itself (markdown)

Terence Parr 2015-01-15 17:16:23 -08:00
parent 39e16e94b6
commit bf5bbf2493
1 changed files with 23 additions and 0 deletions

@ -178,6 +178,16 @@ $ find . -name '*.iml'
./tool/tool.iml
```
# Making ANTLR runtime jar OSGi ready
Without being OSGi compatible, the ANTLR runtime cannot be used within eclipse. That's annoying. To fix this, we have a [pull request](https://github.com/antlr/antlr4/pull/689) that explains what the issue is with OSGi and describes how all we need to do is change the manifest file in the jar.
First, download [bnd](http://www.aqute.biz/Bnd/Bnd) tool and make an alias for convenience:
```bash
alias bnd='java -jar /usr/local/lib/biz.aQute.bnd-3.0.0.jar'
```
# Editing the ANTLR github wiki
If you are a kind soul and would like to fix some of the documentation associated with building and managing handler, such as this page, you can fork antlr/antlr4 at github and then clone from *YOUR_ID*:
@ -185,4 +195,17 @@ If you are a kind soul and would like to fix some of the documentation associate
```bash
$ cd /tmp
$ git clone git@github.com:YOUR_ID/antlr4.wiki.git
```
Our regular `mkjar` bild target generates the following manifest:
```
Manifest-Version: 1.0
Implementation-Vendor: ANTLR
Implementation-Title: ANTLR 4 Runtime
Implementation-Version: 4.5
Implementation-Vendor-Id: org.antlr
Build-Jdk: 1.6
Built-By: parrt
Created-By: http://www.bildtool.org
```