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 not able to parse the STL of GCC 3.x . Preferably use
a gcc 2.xx. If you can't use an old compiler version you might
install the g++-2.9x header files and manipulate the puma.config
file in a way that ac++ uses the old headers while your C++
compiler remains a g++ 3.x. Here is an example of a puma.config
file for g++ 2.96 and a local header file installation in
/home/spinczyk/oldheaders:

--skip-bodies-non-prj
--gnu-2.95
-D __puma
-D __tune_i386__
-D __i386
-D __ELF__
-D __NO_INLINE__
-D __GNUC_MINOR__=96
-D __linux__
-D __linux
-D __unix__
-D __GNUC__=2
-D unix
-D __GNUG__=2
-D __EXCEPTIONS
-D linux
-D __unix
-D __i386__
-D __GNUC_PATCHLEVEL__=0
-D i386
-D __cplusplus
-D __STDC__
-A machine(i386)
-A cpu(i386)
-A system(posix)
-I /usr/include
-I /home/spinczyk/oldheaders/2.96/include
-I /usr/local/include
-I /home/spinczyk/oldheaders/g++-3


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