12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485 |
- LLGEN V1.0.4
- ============
- Copyright © 1991-2005 by the Vrije Universiteit, Amsterdam, the Netherlands.
- 2006-07-26
- INTRODUCTION
- ============
- LLgen is a LL(1) parser in the style of yacc. It will generate an efficient
- recursive descent parser for Extended Context-Free grammars, with an optional
- non-correcting error recovery mechanism.
- For more information, see the white papers in the doc directory. (You may need
- to build LLgen first to be able to read them.)
- INSTALLATION
- ============
- LLgen depends on the following software:
- gcc: currently, LLgen only builds on gcc, due largely to the lack of any
- non-gcc test systems. Please contact the support mailing list (see
- below) if this is a problem.
-
- groff: used to build the documentation.
- LLgen uses Prime Mover as its build tool. To build, do:
- ./pm install
- This will compile LLgen and install it into /usr/local (which you must be able
- to write to). If you want it installed elsewhere, use -D to change the PREFIX
- variable:
- ./pm -DPREFIX="/home/dg/" install
-
- (If you do change the prefix, you must supply it whenever you invoke pm,
- whether you're installing or just building. And there must be a trailing / in
- the path you give it.)
- Invoking ./pm by itself will compile it but not install it; look in the bin
- directory for an image of the installation directory.
- USING LLGEN
- ===========
- Please see the white papers in PREFIX/share/doc/LLgen, or the man page (called
- LLgen).
- LLgen itself uses a parser compiled in LLgen, so you can study the files in
- the src directory for examples. If you wish to modify LLgen's own parser, the
- bootstrap.sh script will update LLgen's source from the parser *.g files.
- LLgen itself may then be recompiled with pm in the usual way. (Although you
- may want to keep a copy of a known good LLgen around in case you break
- something!)
- SUPPORT
- =======
- LLgen is part of the Amsterdam Compiler Kit (although standalone and
- distributed seperately). For more details, please see:
- http://tack.sourceforge.net
- There is a mailing list available at:
- http://sourceforge.net/mail/?group_id=130811
- LICENSE
- =======
- LLgen is © 1991-2005 by the Vrije Universiteit and is distributed under a
- license equivalent to the three-clause BSD license. See the COPYING file
- for details.
- Prime Mover is © 2006 David Given and is distributed under the MIT license.
- Do './pm --license' for details.
- -----------------------------------------------------------------------------
- David Given
- dg@cowlark.com
- 2006-07-21
- /* $Id$ */
|