Archived Repo
=============
This is an archived project and is no longer supported or updated by Facebook. 
Please do not file issues or pull-requests against this repo. If you wish to 
continue to develop this code, we recommend you fork it.

Proceed and be bold!

== Building ==
It's recommended that you build this software with the latest versions of flex
and bison.

You can download flex here:
http://flex.sourceforge.net/

And bison here:
http://www.gnu.org/software/bison/

This software was developed using flex version 2.5.35 and bison version 2.3.
Please note that flex 2.5.4 is OLDER than 2.5.35, and will not be able to build
this software.

To build simply execute `make fbjs`. You can ignore the sign warning in
`yy_get_next_buffer`; I'm pretty sure that's a bug in flex and not in libfbjs.


== How to use ==
To apply the FBJS2 transformations to a program `make fbjs` and pipe a program
to `fbjs`. In cli.cpp you'll find the code needed to invoke this transformation.

To use the FBJS2 parser in other software you may want to check out
jsbeautify.cpp. Documentation is paltry, but it should be pretty easy to get up
to speed if you have a familiarity of Javascript and C++.


== Notes ==
* NodeString expressions are implemented poorly right now. Instead of parsing
  what's in the string we just grab the raw contents from code. This was just
  a hack because I didn't feel like writing the state machine to convert \x,
  \u, \0, etc into bytes.
* There will be a memory leak when you attempt to parse a program with a syntax
  error in it. This is because the authority of freeing allocated nodes is left
  to the parent node. The problem is that the allocated child nodes aren't added
  to the AST until the very last reduciton. Thus, when a ParseException is
  raised the allocated nodes are lost since they never became associated with a
  managed node.
* Handling of virtual semicolons is probably not to spec.