yapp - A perl frontend to the Parse::Yapp module


SYNOPSYS

       yapp [options] grammar[.yp]

       yapp -V

       yapp -h


DESCRIPTION

       yapp is a frontend to the Parse::Yapp module, which lets
       you compile Parse::Yapp grammar input files into Perl
       LALR(1) OO parser modules.


OPTIONS

       Options, as of today, are all optionals :-)

       -v  Creates a file grammar.output describing your parser.
           It will show you a summary of conflicts, rules, the
           DFA (Deterministic Finite Automaton) states and over­
           all usage of the parser.

       -s  Create a standalone module in which the driver is
           included.  Note that if you have more than one parser
           module called from a program, to have it standalone,
           you need this option only for one of your parser mod­
           ule.

       -n  Disable source file line numbering embedded in your
           parser module.  I don't know why one should need it,
           but it's there.

       -m module
           Gives your parser module the package name (or name
           space or module name or class name or whatever-you-
           call-it) of module.  It defaults to grammar

       -o outfile
           The compiled output file will be named outfile for
           your parser module.  It defaults to grammar.pm or, if
           you specified the option -m A::Module::Name (see
           below), to Name.pm.

       -t filename
           The -t filename option allows you to specify a file
           which should be used as template for generating the
           parser output.  The default is to use the internal
           template defined in Parse::Yapp::Output.pm.  For how
           to write your own template and which substitutions are
           available, have a look to the module Parse::Yapp::Out­
           put.pm : it should be obvious.

           If you work on systems that understand so called she­
           bangs, and your generated parser is directly an exe­
           cutable script, you can specifie one with the -b
           option, ie:

               yapp -b '/usr/local/bin/perl -w' -o myscript.pl myscript.yp

           This will output a file called myscript.pl whose very
           first line is:

               #!/usr/local/bin/perl -w

           The argument is mandatory, but if you specify an empty
           string, the value of $Config{perlpath} will be used
           instead.

       grammar
           The input grammar file. If no suffix is given, and the
           file does not exists, an attempt to open the file with
           a suffix of  .yp is tried before exiting.

       -V  Display current version of Parse::Yapp and gracefully
           exits.

       -h  Display the usage screen.


BUGS

       None known now :-)


AUTHOR

       Francois Desarmenien <francois@fdesar.net>


COPYRIGHT

       (c) Copyright 1998-1999 Francois Desarmenien, all rights
       reserved.  See Parse::Yapp(3) for legal use and distribu­
       tion rights


SEE ALSO

       Parse::Yapp(3) Perl(1) yacc(1) bison(1)


Man(1) output converted with man2html