| 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/ |
