Installation
------------

0. Preparation

If you like to use a compiler other than gcc/g++ set the CXX and CC
environment before doing anything else.

for csh/tcsh: setenv CC gcc; setenv CXX g++
for sh/bash : export CC=gcc; export CXX=g++

1. Unpack the tarball in the current directory. All files go into 
<instdir> (aspectc++-0.8pre1).

2. Create puma.config

call from <instdir>
./pumag++conf.pl puma.config

See platform/compile specific notes below for 
necessary manual customization of this file

3. Set PUMA_CONFIG environment to <instdir>/puma.config

for csh/tcsh: setenv PUMA_CONFIG <instdir>/puma.config
for sh/bash : export PUMA_CONFIG=<instdir>/puma.config

If you switch to another compiler repeat steps 3 and 4.

The ac++ binary itself is statically linked and should be ready-to-run. 


Examples
--------

To play with the examples type "make" in the top level directory to
run ac++ on the examples under the examples/ directory. The output is
placed under examples/<Name>-out/. To run an example change to the 
output directory and type "make" and then start the generated binary.

Platform/compiler specific notes
------------------------------

- GCC 3.x (all platforms)

AC++ is now able to parse the STL of GCC 3.x . The workaround (using
the old g++ 2.9x headers for ac++) is no longer needed. To parse g++
3.3 header files the option --gnu has to be given. To parse old 2.9x
header files you have to use --gnu-2.95. The script pumag++conf.pl
will automatically detect the g++ compiler version and write the
correct option into your config file. Maybe it is necessary to
regenerate this config file if you have already one in use.

- MacOS X

Add 

-D_BSD_WCHAR_T_DEFINED_ 

either to ac++ command line or to the $PUMA_CONFIG file

- Solaris 2.8/2.9 (at least)

Add 

-D_WCHAR_T 

either to ac++ command line or to the $PUMA_CONFIG file
Otherwise parsing stdio.h with ac++ generates an error.



- Windows
See README.win32

Contact
-------

Visit http://www.aspectc.org for more information and updated versions.

If you want any information about the AspectC++ project or have any comments, 
feel free to send us mail via info@aspectc.org.