add a couple comments about known-broken things
fix undeclared warnings in the parser

the ones in yy_fatal_error, yyalloc, yyrealloc, and yyfree are due to a
bug in flex (http://sourceforge.net/p/flex/bugs/115/), but i've just
worked around them for now