Author: kjs Date: Thu Aug 7 11:24:31 2008 New Revision: 30100 Modified: trunk/compilers/pirc/README.pod
Log: [pirc] update README a bit. Modified: trunk/compilers/pirc/README.pod ============================================================================== --- trunk/compilers/pirc/README.pod (original) +++ trunk/compilers/pirc/README.pod Thu Aug 7 11:24:31 2008 @@ -20,10 +20,13 @@ PIRC is not finished yet. A lot of work is needed on the back-end before it can generate Parrot Byte Code files (PBC). -Note that pirc/new refers to a Lex/Yacc based implementation, while +Note that pirc/new refers to a Flex/Bison based implementation, while 'pirc' refers to the hand-written recursive-descent implementation, to be found in pirc/src directory. +Please note that the latter (in pirc/src) was an experiment, and is no +longer maintained at this point. Your attention should thus go to pirc/new. + The current set-up is a three-phase compiler: =over 4 @@ -113,7 +116,8 @@ =item * Reentrant -The generated lexer and parser are fully re-entrant. (It does need to be tested, though). +The generated lexer and parser are fully re-entrant, as far as I can tell. +(It does need to be tested, though). =item * Comments! @@ -156,6 +160,13 @@ $ ./pirc -E test.pir + +=head3 Attention! + +The current design does not allow any heredocs in .include-d files, because +the .include directive is implemented in the second phase. This issue should +be solved at some point. + =head2 Cygwin processable lexer spec. The file C<pir.l> from which the lexer is generated is I<not> processable by Cygwin's @@ -229,6 +240,8 @@ =item * C<docs/imcc/> for more documentation about the PIR language. +=item * C<docs/pdds/pdd19_pir.pod> for the PIR design document. + =back =cut
