kmyacc version 4.1.4 (2006/02/15)
=================================

kmyacc is an LALR(1) parser generator, hopefully compatible with
AT&T yacc.

Features:

- Generates smaller table than Yacc/Berkeley yacc/Bison.

- Supports multi-language (currenly C and Java).


INSTALL
=======

(1) You must have ANSI C compiler.

(2) Read Makefile and change macro BIN and PARLIB appropriately.

(3) Type

       make
       make install


HOW TO USE
==========

Command

    kmyacc foo.y

generates parser code "y.tab.c", same as original yacc.

Command

    kmyacc Foo.jy

creates parser code "Foo.java", its class name is "Foo".

Synopsys:

  kmyacc [ -dvltani ] [ -b X ] [ -p XX ] [ -m MODEL ] [ -L LANG ] grammar

Options:

  -d Makes definition file named y.tab.h, which contains definitions of
     token values and the type of semantic stack. (C language only)

  -v Generates file y.output which contains human-readable parser
     tables and diagnostics.

  -l Does not insert #line control directives in y.tab.c.

  -t Generates debugging code.  Compiling with -DYYDEBUG option gives
     the same effect.

  -a Makes semantic actions individual functions rather than blocks in
     one switch statement.  This option is useful if your compiler
     can not compile big functions/methods.

  -b X
     Uses X rather than y as the prefix of generated filenames.
     X.tab.c for C, X.java for Java.

  -p XX
     Uses XX rather than yy as the prefix of global identifiers in
     the parser.  You can avoid collision of external symbols when
     you use more than one parser in the same program by specifing
     this option. (C language only)

  -m MODEL
     Uses file MODEL as prototype of parser code. When defaulted, file
     /usr/local/lib/kmyacc.LANG.parser is taken, where LANG is a host
     language name deduced from source file extension(.y/.jy), or one
     specified by -L switch explicitly.

  -L LANG
     Specifies LANG as host programming language. c,java,javascript,perl
     are available.

  -n
     Allows referencing semantic values by name.

  -i
     Inhibits referencing semantic values by $$, $1, $2 form.

Environment
   KMYACCPAR	Prototype file name. Same as -m option.



Differences between kmyacc and AT&T yacc
========================================

-  Options -b, -p, -a, -m, -L added

-  Bison's %expect, %pure_parser statement added

-  Treat // as comment

-  Following obsolete features deleted
	o literal tokens surrounded by "
	o \left, \right etc.
	o %<, %>, %binary, %2, %0, %=

-  YYBACKUP macro not supported




COPYRIGHT
=========

Copyright (C) 1987,1989,1992,1993,2005,2006  MORI Koichiro.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA


CONTACT
=======
Bug reports, suggestions, patches are welcome.
Please send email to:

  MORI Koichiro <kmori@acm.org>