Re: I need simpler examples (was: RE: Enhancement request: enabling Variant in C parsers)

[Akim Demaille]

> Le 9 déc. 2018 à 17:06, Askar Safin <address@hidden> a écrit :
> 
> Hi, Akim.
> 
>> So I still believe the documentation, with rpcalc and mfcalc are the simple 
>> examples you are asking for, and then the flex example (in examples/c, not 
>> in the documentation) should be good starting points, with locations.
> What examples/c you are talking about? I don't see "c" directory here: 
> http://git.savannah.gnu.org/cgit/bison.git/tree/examples .

It was created today (it exists now).  In contains rpcalc and mfcalc that were 
in examples/ before, and now it also contains lexcalc.

>> You are right.  I have to find where exactly.  Suggestions welcome.
> To the end of "2. Examples". Even if you don't find good way to add to docs, 
> at least, please add to "11. Frequently Asked Questions".

I'll check that, thanks for the suggestion.


>> It's an ongoing effort.  If you look the history of the examples you'll see 
>> that they are getting Makefiles and READMEs.  In particular calc++ has its 
>> Makefile, so your comment is quite inaccurate.
> Oops, again my fault. Also, Debian version of Bison doesn't have this 
> Makefile. I mean that package "bison-doc 1:3.2.2-1" has dir 
> /usr/share/doc/bison-doc/examples/calc++ and it has no Makefile. This is 
> their bug, of course

Please report this to them!  The Makefiles are to be installed together with 
the READMEs.  Here is what I have currently when I run make install:

$ cd /opt/gostai/share/doc/bison
$ find .
.
./AUTHORS
./README
./TODO
./COPYING
./NEWS
./examples
./examples/c++
./examples/c++/calc++
./examples/c++/calc++/driver.cc
./examples/c++/calc++/location.hh
./examples/c++/calc++/Makefile
./examples/c++/calc++/scanner.ll
./examples/c++/calc++/driver.hh
./examples/c++/calc++/README.md
./examples/c++/calc++/calc++.cc
./examples/c++/calc++/parser.yy
./examples/c++/Makefile
./examples/c++/README.md
./examples/c++/variant-11.yy
./examples/c++/simple.yy
./examples/c++/variant.yy
./examples/java
./examples/java/Calc.y
./examples/java/Makefile
./examples/java/README.md
./examples/README.md
./examples/c
./examples/c/README.md
./examples/c/rpcalc
./examples/c/rpcalc/Makefile
./examples/c/rpcalc/rpcalc.y
./examples/c/rpcalc/rpcalc.c
./examples/c/rpcalc/rpcalc.gv
./examples/c/rpcalc/rpcalc.html
./examples/c/lexcalc
./examples/c/lexcalc/Makefile
./examples/c/lexcalc/scan.l
./examples/c/lexcalc/README.md
./examples/c/lexcalc/parse.y
./examples/c/mfcalc
./examples/c/mfcalc/mfcalc.y
./examples/c/mfcalc/Makefile
./examples/c/mfcalc/calc.h
./examples/d
./examples/d/calc.y
./examples/d/Makefile
./examples/d/README.md
./THANKS