READ_ME 2.6 KB

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