DocXYZgrammar.txt

The Language XYZgrammar
BNF Converter


%This txt2tags file is machine-generated by the BNF-converter
%Process by txt2tags to generate html or latex



This document was automatically generated by the //BNF-Converter//. It was generated together with the lexer, the parser, and the abstract syntax module, which guarantees that the document matches with the implementation of the language (provided no hand-hacking has taken place).

==The lexical structure of XYZgrammar==
===Identifiers===
Identifiers //Ident// are unquoted strings beginning with a letter,
followed by any combination of letters, digits, and the characters ``_ '``
reserved words excluded.


===Literals===

Integer literals //Integer// are nonempty sequences of digits.


String literals //String// have the form
``"``//x//``"``}, where //x// is any sequence of any characters
except ``"`` unless preceded by ``\``.




===Reserved words and symbols===
The set of reserved words is the set of terminals appearing in the grammar. Those reserved words that consist of non-letter characters are called symbols, and they are treated in a different way from those that are similar to identifiers. The lexer follows rules familiar from languages like Haskell, C, and Java, including longest match and spacing conventions.

The reserved words used in XYZgrammar are the following:
  | ``Generator`` | ``bool`` | ``else`` | ``false``
  | ``for`` | ``func`` | ``if`` | ``int``
  | ``next`` | ``nextOrDefault`` | ``print`` | ``println``
  | ``return`` | ``string`` | ``true`` | ``void``
  | ``while`` | ``yield`` |  | 

The symbols used in XYZgrammar are the following:
  | { | } | ; | =
  | , | ( | ) | :
  | & | func* | . | <
  | > | - | ! | &&
  | || | + | * | /
  | % | <= | >= | ==
  | != |  |  | 

===Comments===
Single-line comments begin with //.Multiple-line comments are  enclosed with /* and */.

==The syntactic structure of XYZgrammar==
Non-terminals are enclosed between < and >. 
The symbols -> (production),  **|**  (union) 
and **eps** (empty rule) belong to the BNF notation. 
All other symbols are terminals.

  | //Program// | -> | //[Stmt]// 
  | //Block// | -> | ``{`` //[Stmt]// ``}`` 
  | //[Stmt]// | -> | **eps**
  |  |  **|**  | //Stmt// //[Stmt]// 
  | //Stmt// | -> | ``;`` 
  |  |  **|**  | //Block// 
  |  |  **|**  | //Type// //[Item]// ``;`` 
  |  |  **|**  | //Ident// ``=`` //Expr// ``;`` 
  |  |  **|**  | ``return`` //Expr// ``;`` 
  |  |  **|**  | ``return`` ``;`` 
  |  |  **|**  | ``if`` ``(`` //Expr// ``)`` //Block// 
  |  |  **|**  | ``if`` ``(`` //Expr// ``)`` //Block// ``else`` //Block// 
  |  |  **|**  | ``while`` ``(`` //Expr// ``)`` //Block// 
  |  |  **|**  | ``for`` ``(`` //Type// //Ident// ``:`` //Expr// ``)`` //Block// 
  |  |  **|**  | //Expr// ``;`` 
  |  |  **|**  | ``func`` //Type// //Ident// ``(`` //[Arg]// ``)`` //Block// 
  |  |  **|**  | ``func*`` //Type// //Ident// ``(`` //[Arg]// ``)`` //Block// 
  |  |  **|**  | ``yield`` //Expr// ``;`` 
  |  |  **|**  | ``print`` ``(`` //Expr// ``)`` ``;`` 
  |  |  **|**  | ``println`` ``(`` //Expr// ``)`` ``;`` 
  | //Item// | -> | //Ident// 
  |  |  **|**  | //Ident// ``=`` //Expr// 
  | //[Item]// | -> | //Item// 
  |  |  **|**  | //Item// ``,`` //[Item]// 
  | //Arg// | -> | //Type// //Ident// 
  |  |  **|**  | //Type// ``&`` //Ident// 
  | //[Arg]// | -> | **eps**
  |  |  **|**  | //Arg// 
  |  |  **|**  | //Arg// ``,`` //[Arg]// 
  | //Expr6// | -> | //Ident// ``.`` ``next`` ``(`` ``)`` 
  |  |  **|**  | //Ident// ``.`` ``nextOrDefault`` ``(`` //Expr// ``)`` 
  |  |  **|**  | //Ident// 
  |  |  **|**  | //Integer// 
  |  |  **|**  | ``true`` 
  |  |  **|**  | ``false`` 
  |  |  **|**  | //Ident// ``(`` //[Expr]// ``)`` 
  |  |  **|**  | //String// 
  |  |  **|**  | ``(`` //Expr// ``)`` 
  | //Type// | -> | ``int`` 
  |  |  **|**  | ``string`` 
  |  |  **|**  | ``bool`` 
  |  |  **|**  | ``void`` 
  |  |  **|**  | ``Generator`` ``<`` //Type// ``>`` 
  | //Expr5// | -> | ``-`` //Expr6// 
  |  |  **|**  | ``!`` //Expr6// 
  |  |  **|**  | //Expr6// 
  | //Expr4// | -> | //Expr4// //MulOp// //Expr5// 
  |  |  **|**  | //Expr5// 
  | //Expr3// | -> | //Expr3// //AddOp// //Expr4// 
  |  |  **|**  | //Expr4// 
  | //Expr2// | -> | //Expr2// //RelOp// //Expr3// 
  |  |  **|**  | //Expr3// 
  | //Expr1// | -> | //Expr2// ``&&`` //Expr1// 
  |  |  **|**  | //Expr2// 
  | //Expr// | -> | //Expr1// ``||`` //Expr// 
  |  |  **|**  | //Expr1// 
  | //[Expr]// | -> | **eps**
  |  |  **|**  | //Expr// 
  |  |  **|**  | //Expr// ``,`` //[Expr]// 
  | //AddOp// | -> | ``+`` 
  |  |  **|**  | ``-`` 
  | //MulOp// | -> | ``*`` 
  |  |  **|**  | ``/`` 
  |  |  **|**  | ``%`` 
  | //RelOp// | -> | ``<`` 
  |  |  **|**  | ``<=`` 
  |  |  **|**  | ``>`` 
  |  |  **|**  | ``>=`` 
  |  |  **|**  | ``==`` 
  |  |  **|**  | ``!=``