| Tree Compiler-Compiler | |
| ====================== | |
| The treecc program is designed to assist in the development of compilers | |
| and other language-based tools. It manages the generation of code to handle | |
| abstract syntax trees and operations upon the trees. | |
| A fuller account of why treecc exists and what it can be used for can | |
| be found in the Texinfo documentation within the "doc" subdirectory, | |
| and in the introductory article "doc/essay.html". | |
| Downloading and Building | |
| ------------------------ | |
| The latest version of treecc can be obtained from the following Web site: | |
| http://www.southern-storm.com.au/treecc/ | |
| To build and install, unpack the ".tar.gz" file into a temporary directory | |
| and execute the following commands: | |
| $ ./configure | |
| $ make all | |
| $ make check | |
| $ make install | |
| The "make check" runs the treecc test suite to check for any problems | |
| on your system. Report any such problems to the authors, together with | |
| a script of the failed test output. | |
| If you obtained the treecc sources via CVS, you will need to run the | |
| following before "./configure": | |
| $ ./auto_gen.sh | |
| If you wish to install treecc somewhere other than the default prefix | |
| ("/usr/local"), use the following configuration command instead: | |
| $ ./configure --prefix=PREFIX | |
| where "PREFIX" is the full pathname of the directory where you want to | |
| install the program. | |
| If you want to add a new output language, see "doc/extending.txt". | |
| Copyright Considerations | |
| ------------------------ | |
| Treecc is distributed under the terms of the GNU General Public License. | |
| A copy of this can be found in the "COPYING" file. | |
| However, it is not our intention to restrict the use of treecc to only | |
| free software providers. Use by commercial software vendors is welcome. | |
| When you use treecc on your own input files to generate source code as | |
| output, the resulting source code files are also owned by you. You may | |
| re-distribute unmodified copies of these output source files, and any | |
| binaries derived from them, in any way you see fit. | |
| If you modify treecc itself, and generate new output files as a result, | |
| then you must release all modifications to treecc with your program so | |
| that other users can benefit from your changes under the terms of the GPL. | |
| Contact the authors if you have any questions regarding the above. | |
| It is our intention to allow the same amount of access to treecc output | |
| files as is currently available using the GNU Bison and Flex programs. | |
| Contacting the Authors | |
| ---------------------- | |
| The authors can be contacted via e-mail at the following address: | |
| treecc@southern-storm.com.au | |
| Also check our Web site for updates to treecc: | |
| http://www.southern-storm.com.au/treecc/ |