# ***** BEGIN LICENSE BLOCK *****
# Version: MPL 1.1/GPL 2.0/LGPL 2.1
#
# The contents of this file are subject to the Mozilla Public License Version
# 1.1 (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
# http://www.mozilla.org/MPL/
#
# Software distributed under the License is distributed on an "AS IS" basis,
# WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
# for the specific language governing rights and limitations under the
# License.
#
# The Original Code is Aspicere.
#
# The Initial Developer of the Original Code is
# the Software Engineering Lab, INTEC, University Ghent.
# Portions created by the Initial Developer are Copyright (C) 2004
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Kris De Schutter <kris.deschutter@ugent.be>
#   Bram Adams <bram.adams@ugent.be>
#
# Alternatively, the contents of this file may be used under the terms of
# either the GNU General Public License Version 2 or later (the "GPL"), or
# the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
# in which case the provisions of the GPL or the LGPL are applicable instead
# of those above. If you wish to allow use of your version of this file only
# under the terms of either the GPL or the LGPL, and not to allow others to
# use your version of this file under the terms of the MPL, indicate your
# decision by deleting the provisions above and replace them with the notice
# and other provisions required by the GPL or the LGPL. If you do not delete
# the provisions above, a recipient may use your version of this file under
# the terms of any one of the MPL, the GPL or the LGPL.
#
# ***** END LICENSE BLOCK *****

[ Dependencies ]

- Yerna Lindale (tested with nelya)

  Basic infrastructure.

- Lillambi

  Basic framework on which Aspicere (and Cobble) are built.


[ Preparing the environment (bash) ]

You need to add the following lines to your .bash_profile for
Aspicere to do its stuff :

--
export YERNA_LINDALE=~/path_to_yerna-lindale
export LILLAMBI=~/path_to_lillambi
export ASPICERE=~/path_to_aspicere

export PATH=$ASPICERE/bin:$YERNA_LINDALE/bin:$LILLAMBI/bin:$PATH
--


[ Real installation ]

- Yerna Lindale

  cd $YERNA_LINDALE
  make light

- Lillambi

  cd $LILLAMBI
  make

- Aspicere

  cd $ASPICERE
  make


[ Test applications ]

In the sandbox/-directory, some small programs illustrate various aspects of Aspicere (no pun intended). To test these, just:

  cd $ASPICERE/sandbox
  cd sabotage
  make test


***************
*** WARNING ***
***************

The sandbox/database/optimizer-example does not work yet in GCC 4.X (except for OSX), because statements like:

(char*)voidptr=charptr; /* voidptr=(void*)charptr; is the correct code */

... do not compile anymore (hard error now vs. warning in pre-4.X GCC versions). This means that modifying captured arguments of an advised procedure call is (currently) not possible in GCC 4.X.

***************
*** WARNING ***
***************