# Copyright 2022 Jeffrey Kegler # This file is part of Marpa::R2. Marpa::R2 is free software: you can # redistribute it and/or modify it under the terms of the GNU Lesser # General Public License as published by the Free Software Foundation, # either version 3 of the License, or (at your option) any later version. # # Marpa::R2 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 # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser # General Public License along with Marpa::R2. If not, see # http://www.gnu.org/licenses/. =head1 Name Marpa::R2::Deprecated::Stuifzand - Stuifzand Interface (DEPRECATED) =head1 THE STUIFZAND INTERFACE IS DEPRECATED The Stuifzand interface (also sometimes called the "BNF interface") is deprecated. PLEASE DO NOT USE IT FOR NEW DEVELOPMENT. =head1 Synopsis =for Marpa::R2::Display name: Stuifzand Synopsis partial: 1 normalize-whitespace: 1 use Marpa::R2; my $grammar = Marpa::R2::Grammar->new( { actions => 'My_Actions', default_action => 'do_first_arg', source => \(<<'END_OF_SOURCE'), :start ::= Script Script ::= Expression+ separator => action => do_script Expression ::= Number | () Expression () action => do_parens assoc => group || Expression () Expression action => do_pow assoc => right || Expression () Expression action => do_multiply | Expression () Expression action => do_divide || Expression () Expression action => do_add | Expression () Expression action => do_subtract END_OF_SOURCE } ); =for Marpa::R2::Display::End =head1 Overview This page is the reference for the Marpa's "Stuifzand interface", also called its "BNF interface". Use of the Stuifzand interface is now deprecated, in favor of L. Almost all of the functionality of the Stuifzand interface can be duplicated in the SLIF interface by switching immediately to external scanning, and never switching back to internal scanning. To switch immediately to external scanning in the SLIF, specify a length of zero for its initial L|Marpa::R2::Scanless::R/"read()">. For more details, see the L. =head1 The source string Stuifzand interface source strings are specified using the L named argument of Marpa::R2's grammars|Marpa::R2::Deprecated::NAIF::Grammar/"source">. BNF source strings perform the functions of the L|Marpa::R2::Deprecated::NAIF::Grammar/"rules"> and the L|Marpa::R2::Deprecated::NAIF::Grammar/"start"> named arguments of Marpa grammars. When the C named argument is used to specify a grammar, the C and C named arguments should not be used, and vice versa. The syntax for the Stuifzand interface's source string is the same as L, except that features and syntax not relevant to the Stuifzand interface are not supported. Everything related to L0 grammars is unsupported. L0 grammars do not exist in the Stuifzand interface. Lexemes, character classes and quoted strings all implicitly require a L0 grammar to exist and therefore, they also are not supported. Since the Stuifzand interface does not implement internal scanning, everything to do with internal scanning is unsupported. SLIF parse events are the most visible of these features. In most cases, when features have introduced after the SLIF replaced the Stuifzand interface as Marpa's primary interface, those features have been retro-ported if they make sense in the Stuifzand context. However, this will necessarily always be the case in the future. Here is a list of some of the unsupported SLIF DSL features, =over 4 =item * Character classes These implicitly use the L0 grammar. =item * Quoted strings These implicitly use the L0 grammar. =item * Discard rules C<:discard> rules control the behavior of the L0 grammar. =item * The lexeme and lexeme default statements The C<:lexeme> pseudo-rule and the lexeme default statement define the behavior of lexemes. Lexemes in the SLIF sense do not exist in the Stuifzand interface. =item * L0 rules Rules with the tilde declarator ("C<~>") defined L0 rules. =item * Event declarations Parse events exist to trigger returns from the SLIF internal scanning methods. =item * The pause adverb The pause adverb exists to trigger returns from the SLIF internal scanning methods. =item * The priority adverb The priority adverb defines lexeme priorities. Lexemes in the SLIF sense do not exist in the Stuifzand interface. =item * Actions specified as array descriptors Actions specified as array descriptors, for example, =for Marpa::R2::Display ignore: 1 action => [start,length,value] =for Marpa::R2::Display::End exist primarily to support lexeme semantics. They can also specify rule semantics, but their functionality has not been retro-ported to the Stuifzand interface, and probably never will be. =back =head1 Copyright and License =for Marpa::R2::Display ignore: 1 Copyright 2022 Jeffrey Kegler This file is part of Marpa::R2. Marpa::R2 is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Marpa::R2 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 Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with Marpa::R2. If not, see http://www.gnu.org/licenses/. =for Marpa::R2::Display::End =cut # Local Variables: # mode: cperl # cperl-indent-level: 4 # fill-column: 100 # End: # vim: expandtab shiftwidth=4: