windows-server-2003/inetsrv/query/kbyacc

//+-------------------------------------------------------------------------

//

//  THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF

//  ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO

//  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A

//  PARTICULAR PURPOSE.

//

//  Copyright (c) 2001 Microsoft Corporation.  All Rights Reserved.

//

//--------------------------------------------------------------------------



Description

===========

  Kbyacc is a modified version of the Berkeley YACC. All the modified portion 

  are surrounded by #ifdef, #endif. 

  

  

User's Guide

============

 Skeleton.c contains the skeleton of the parser class (YYPARSER). YYPARSER derives from 

 a custom base class. There are references in the skeleton to XGrowable for stack allocation 

 which is our own custom allocator. This allocator defaults to an initial in-instance 

 allocation and if that is insufficient growth is through a separate heap object. This 

 allocator also features auto memory cleanup at the destructor. 

 

Usage

=====

 usage: KBYacc.exe [-f sql/triplish] [-dlrtv] [-b file_prefix] [-p symbol_prefix] 

 [-c baseclass <args>] filename

 

 -f flag is a custom flag for our own 2 different parsers, default is sql parser. The 

    skeleton for the triplish parser is slightly different from the sql parser.

    

 -d flag specifies the name of the define file (the default name is y.tab.h)

 

 -l please refer to the document NEW_FEATURES

 

 -r please refer to the document NEW_FEATURES

 

 -t please refer to the document NEW_FEATURES

 

 -v Verbose mode

 

 -b [file_prefix] - file_prefix specifies the prefix of the output files. Default 

		    value is "y"

    

 -p [symbol_prefix] - symbol_prefix specifies the value of YYPREFIX, which is used as

		      prefix for all the parser variables, i.e. the value stack, etc. 

		      Default value is "yy"

 

 -c [baseclass <args>] - The parser class(YYPARSER) inheritates from this base class that

			 you can customize. <args> is the argument list of the constructor

			 to the base class.

 

 [filename] - name of the input file      



Makefile.inc

============

The following is fragment from a sample makefile.inc 



trparse.cxx parser.h: parser.y

    kbyacc -f triplish -d -l -b parser -p trip -c CTripYYBase "(IColumnMapper & ColumnMapper, LCID & locale, YYLEXER & yylex)" parser.y

    attrib -r trparse.cxx 2>nul

    attrib -r parser.h 2>nul

    -del trparse.cxx

    -del parser.h

    -ren parser.tab.c trparse.cxx

    -ren parser.tab.h parser.h

    

parser.y is the grammar input file. parser.tab.h and parser.tab.c are the header and 

the implementation files genearted. This fragment shows that trparser.cxx and parser.h are 

depedent of parser.y. kbyacc is called with input file parser.y with base class CTripYYBase, 

The parameter list for the construtor is 

"(IColumnMapper & ColumnMapper, LCID & locale, YYLEXER & yylex)". parser.tab.c and 

parser.tab.h are then renamed to trparser.cxx and parser.h respectively. 





Skeleton files

==============

The Header1, Header2, Header3 arrays contain the code for the header file generated. 

The Body and Trailer arrays contain the code for the implementation of yyparser.

 

Bugs fixed

==========

An array out of bound access bug to the check array is fixed in output.c