  * add parsing strings and trees as a test

  * Update documentation

  * add to YYPreParse one option for debugging the preparsing.
    idem for other options

  * add eyapp -Y option: equivalent to "%tree bypass"

  * Expected and language generation for article 

  * Lalr 
      # substitute End Of Input by DEFAULT for each state
      # Will it give a false acceptance? 
      # I think I shall use an option in eyapp?
      # make a test

  * Merge PPCR branch with trunk

  * Include %from directive. See examples/debuggingtut/Range2.eyp

        %from pascalnestedeyapp2 import expr
        # alternative syntax to include also semantic actions
        #%from pascalnestedeyapp2 use expr
        #%from pascalnestedeyapp2 use expr, TAIL 

        %%
        range: expr '..' expr ';'
        ;

        %%

  * Change the API for YYSetReduce and YYSetshift to include the name of the conflict?

  * Bug/limitation: When using -m and -o the output file still uses the original grammar name.
    It seems more convenient to rename it to the output file suffixed with .output

  * Generation of Several Parsers
      - %PREC conflict does not check that a conflict handler has been previously declared
      - The lexer must be the one of the main parser
      - The accept state must change
          A$ -> A
          A$ -> A.b where b is in the follow of A, means acceptation
          Where are the follows?. They have been computed somewhere
      - Avoid warnings: rule not used, rule not used, etc. How?
        Shall I use a subgrammar that is the closure of the syntactic variable

  * Lexical Analyzer generation:
      * incremental lexer also influences the way the directive
                                 %lexer 
         must behave. Because a lexer written by hand can be incremental
      * support streams: see lexer in examples/Eyapp/Lhs1.yp
        - Parse::Eyapp::Driver::input called as a setter receives an open file handler :
                  prompt!
        - if the input string is finished it reads from the file handler (controled by $/)
          otherwise returns the current string
      * error line numbers-> source code
      * lexer must support a sub name
         %lexer mylexer
      *  Document:
            =head3 $parser->input YYInput
            =head3 $parser->YYInputFile

            =head3 $parser->YYPrompt

            =head3 $parser->main

            =head3 $parser->Run


  * %tree: 
     - info  clause (autobuild ::info for TERMINAL) 
     - naming scheme clause

  * Tests
     - tests all examples/*/*yp for syntax checking
     - test for yyfilename
     - Add tests to check .output tables: actions and gotos against yacc. 
        I am not confident that some modifications I introduced in Grammar.pm were error free
     - Automatic naming scheme: tests!
     - Some rules can be optimized away. Then the name dissapears!!
     - tests with syntax errors
     - Debug mode and standalone works?

  *  Debugging: set breakpoints in the code from yydebug=> 1

  * What if the input comes from a stream? then $parser->input is undef
    Shall I support interactive streams?
      - YYLookaheads assumes that input comes from $parser->input
      - The default lexer assumes that input comes from $parser->input
      Change it to use an input stack

  * PPCR:
     - The whole implementation approach seems wrong. 
       Make actions an array. Associate the handler with the state.
       That allows a syntax like:
                          %conflict handler {... } 
                          %shift-reduce prod1 [token1, token2, ...] prod2 [tokens] handler
                          %reduce-reduce prod3 [token1, token2, ...] prod4 [tokens] otherhandler
                          ....

     - There is a bug: I have to check that reductions in PPCR only occur inside the conflictive states

     - Warning Grammar.pm 
         sub Parse::Eyapp::Grammar::conflictHandlers  rewrite! or use Data::Dumper forever?

  * %package directive: equvalent to eyapp -m option 

  * -%modulino directive 
      %modulino perlinterpreter prompt
      Equivalent to eyapp -b 'perlinterpreter' and __PACKAGE__->main(prompt) 
      %modulino '/usr/local/lib/perl/5.10.1/bin/perl5.10.1' 'Try input "type e = (x);": '
      
      avoid repetitive __PACKAGE->main when using options -C and -b

  * Article: rewrite, both research and divulgation

  * Documentation
     - Simpler intro
     - Separate parsing from tree transformation


  * EBNF (a|b|c)*
    - eyapp option -TREE: same as %tree
      currently only give_rhs is used, but it has to be parametrized

  * - eyapp option namingscheme

    - eyapp option -start (defines the start symbol)
       Eyapp -> Lalr -> Grammar -> Options
                            `----> Parse
    - intermediate actions in give_rhs_name? check, test
    
  * Error message when a conflict handler isn't used is inaccurate:

      ~/LEyapp/examples/debuggingtut$ eyapp dynamicgrammar.eyp 
      Useless non-terminals:

          rangeORenum, declared line 10

      Useless rules:

          rangeORenum -> 

      1 shift/reduce conflict and 0 reduce/reduce conflicts

  *  Line numbers seem to be in a buggy state.
     There is also a "bug" with tokenline and the static attribute approach: tokenline
     attribute is defined to 1 while the static/attribute approach searches while "undef"

  * Lars request (see dir contributions): allow AST classes to be Moose or any other OOP framework

  * Provide a module providing regexp for most common non destructive lexing: NUMs, IDs, etc

      use Parse::Eyapp::LexSupport qw{INT PERLWS ID};

      Created by "new" so that $self is in scope

         $INT = qr{\G(\d+)}gc; $WS = qr{{\G(\s*) (?{  $self->tokenline($1 =~ tr{\n}{}) }) }gxc; etc.

      tokens can be "defined" with:

          %token DOTDOT /(\.\.)/ 
          %token INT /(\d+)/ 

      The parser will define $DOTDOT = qr{/\G(\.\.)/;
      and then:

      PERLWS(); # No need to update the line number

      m{\Gtype\b}gic           and return ('TYPE', 'TYPE'); # old way

      m{$ID}gc                 and return ('ID',  $1);

      INT()                    and return ('NUM', $1);

      DOTDOT()                 and return ('DOTDOT',  $DOTDOT);

      m{\G(.)}gc               and return ($1,    $1);

  * Parse::Eyapp::Driver::main 
     - option to send output to a file

  * bison directives: 

        Directive: %debug
            In the parser file, define the macro YYDEBUG to 1 if
            it is not already defined, so that the debugging
            facilities are compiled.

        Directive: %no-parser
            Do not include any C code in the parser file; generate

        Directive: %no-lines

        Directive: %output="filename"


  * the #line directive in Parse.yp for %lexer is prone to be buggy (worst practice)


  * Dynamic conflict resolution: test YYSetShift
        The case where the default is a reduction is not solved. Investigate

  * Further study YAML (class preservation)

  * Provide debugging support for standalone modules: currently skipped

  * Provide an argument named 
                                'end_of_input' => [ token list: '', NUM, etc. ]

    to be used in YYParse. When an error is found, if the token is in the set 'end_of_input' the input
    will be accepted if in the accepting state

  * There is a bug in eyapp with reduce-reduce conflicts?! I am not sure of this
    with reduce-reduce conflicts. In at least one case is reducing by the second production rule instead 
    of the first.  It appears in the C++ parser (t/99Cplusplusgrammar.t). Confirm

  * There is a bug with &give_rhs_name in Parse::Eyapp::Grammar and lists *, +, etc. see the example
      examples/debuggintut/SemanticInfoInTokens.eyp

    Not always a syntactic variable is a valid identifier: e.g. PLUS-1
    Probably, it is better that the method "tokennames" give names to the syntactic variables

  * str method to produce GraphViz, latex and/or other formats

  * Treereg EXPORT and EXPORT_OK

  * Language generation example examples/generator
     -- Return a Test::LectroTest::Generator? 


  * Check that all the production names (given with %name directives) are different. May be not

  * Combine Flex and eyapp

  * Grammar reuse, grammars as subroutines/methods: a grammar subroutine for variable B 
    is implemented via 

             B -> FIRST(B) { CALL PARSER FOR B}

     The sublanguage is a set of tokens from the superlanguage perspective. The token attribute is the value
     returned by the parser. The lexer must be changed to finish when a FOLLOW(B) is found. Line number
     and input require special consideration

  *  Introduce the directive %input FILE. We need to control line numbers and file names for this.
     May be we need a full preprocessor for this

  * When using option %delegateaction we must check that the client must have 
  methods with names the names of the production rules (see example in the Simon's book
  Advanced programming for this). In fact is a case of "abstract method"

  * There is a generic 'Error' routine: provide it

  * Not sure: eyappoption -t will generate a 'tag' file

  * target 'version' in Makefile.PL: make a vim script

  * PUBLIC_PLACE implies to copy to a remote machine (nereida)

  * Implement the directive
       %package Math::Calc 
    (like the option -m of eyapp)

  * common examples generated through the text template. Idem MANIFEST

  * Lexical analyzer seems to be in a mess: line count seem full of bugs

  * delete_method isn't documented
  * Document generate, new, etc. in treeregexp
  * Add to Parse::Eyapp::Base function
             MakeHierarchy('BinaryOp(PLUS, TIMES, MINUS, DIV) Operation(BinaryOp)')
    that will build a inheritance hierarchy

  * Unify: to support trees and not only dags a symbol table will be helpful
  * Parse::Eyapp::Node->new: Probably s.t. like
     TUTU(TITI({ $[0]->{chu} = 4 }) {$_[0]->{k} = "hello"})
    will be better to initialize the attributes

  * Document Parse::Eyapp::Base
- Distribution
  * Attributed Grammars
  * ABSTRACT 
  * Output files .pm generated by the tests. Don't
  * numchildren method
  * token definitions %token NUM = qr{\d+}
    It can be used later in the lexer as
           return ('NUM', $1) if m{($NUM)};
    That is the $NUM variable will be declared. Scope?
 
  ***** Reorganize the translation of Treeregexp: the code in the "and" and =>
    clauses will be a method of the classes of the nodes matching the treeregexp
    - $treereg->classes computes the classes. doing nothing yet
    - @{$methods{$_}} contain the classes
    - Methods Parse::Eyapp::Treeregexp::REGEXP_INNER::classes included
    - Factorize

  * star treeregexp will be supressed *
  * Introduce DECLARATION* in treeregexes
  * "previous" clause for YATW objects when using "bud". The YATW will 
    be executed before visiting the children. An example of the advantage
    of doing this is to use "bud" for scope analysis
  * %default action must have an scope
  * Factorize YYBuildAST and YYActionforT_TX1X2 etc.
    There is a problem with TERMINAL::save_attributes ?
    bypass, plus and star lists, etc. There is no coherent interface
    at the moment
  * version numbers
  * Warning diagnostic (Yure): ID and 'ID' is prone to error
    Non defined variables are considered terminals: see Identifyattr2.yp. Put info in Output
  * Better diagnostics: see -v 
  * Redesign eyapp program structure for documentation (pods): head body legs tail 
    (or __END__ ?)
  * .output in HTML (?)
  * Some data structures inside the Parser object are only required 
    if the %tree or %metatree directives are active. Otimize them away
    when they are not used (for example syntax tokens, bypass, etc.).
  * Change names of _PLUSLIST, etc. Make a directive to name them 
       %name * => _STAR  + => ... , etc.
    It may influence optimizations like the PARENTHESIS one?
  * bypass method for YATW and Node objects

  * Fix the yyprefix consistency problem between new and YYParse (args)
  * What is YYFilename in Driver.pm

  * Reference manual. Document functions and methods
    -- Sort by alphabetical order
    -- User methods and subroutines. Internal documentation

- Treereg Tree grammars and tree walkers
 

  * Uniformize 
     - Lower case in new_grammar, uppercase in Treeregexp new, etc.
     - Also look at scripts

  * Private methods
  * Indentation and line numbers. 

- Translation Schemes
  * Scheme examples: leftrec, etc.
  * Tests
    - In TS delete the code refs using treeregexp
  * Documentation
  * Executable transscheme
  * Delete args in YATW objects it seems they are no use
  * TERMINAL nodes inherit from TS and Node. What if I have two parsers
    in the same application?
  * Put option %yaml file when using a translation scheme to save the AST

  * TS: Don't check syntax during the construction phase?
  * Check syntax option in eyapp
  * Keep Line Numbers in the tree (for tokens)

  * Factorize lists code
  * Admitir directivas-especificaciones de si la lista debe ser left-recursive o right-recursive
  * Esquema de nombres de las reglas temporales:
      Reservar la numeracin de las reglas de la gramtica original
      y usar posiciones adicionales para las reglas temporales.
  * Hacer una directiva para la generacion de reglas de error en listas
  
  * Supress when production code use Data::Dumper;
  
  * %packagename %outputfile %numbers, etc.
  
- Optimizations:
  * Driver in C
  * BuildAST in C


************ PROJECTS *********************
* Human friendly warnings and errors, conflicts, debugger with breaks, etc.

