Serial programmer for Philips/NXP LPC21xx CPUs
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
LICENSE
Makefile
README
buid.sh
intelhex.ml
lpcsprg.ml

README

Aurochs, a parser generator.

  Copyright (C)2007-2009 Exalead SA
  Author: Berke Durak

  http://aurochs.fr/

Installation.
=============
1) You can try aurochs on-line at http://aurochs.fr/

2) You need Objective Caml 3.10 or later.  See http://caml.inria.fr/

   On Debian-like systems:
     apt-get install ocaml-nox

3) You also need the usual development tools (GNU Make, C compiler).

4) make (or gmake)

5) Typing
     sudo make PREFIX=/usr/local install
   will install the aurochs binary in /usr/local/bin and the Ocaml
   libraries in the Ocaml installation directory, as determined
   by
     ocamlc -where.

6) You can also use ./aurochs_tool.native if you do not want to install
   aurochs.

Testing
=======
1) There are some grammars in examples/.  You can parse them using
   Aurochs right away:

     aurochs -parse examples/test.markup examples/markup.peg

   Aurochs will print an XML-like representation of the parse tree.
   This is how you develop your grammar.

2) Once your grammar is OK, you generally use Aurochs to save the resulting
   automaton into a binary file.  The command

     aurochs -target nog examples/markup.peg

   will create a file markup.nog

3) You can parse a file using that NOG file:

     aurochs -parse examples/test.markup examples/markup.peg -load-nog markup.nog

4) There is an example C program in c/test/test_nog which does the same thing.

    _build/c/test/test_nog markup.nog examples/markup.peg

5) There are Ocaml examples in examples/calculator and examples/cgi-bin.

6) There is a Java example in java/.  Ensure you have Java 1.6 handy and type "make test" there.
   For Java 1.5, comment out the "@SuppressWarnings" annotation in java/fr/aurochs/Node.java.