File Release Notes and Changelog
Release Name: 0.1.0
Notes:
--------------------------------------------------------------------------------
Retargetable Server Pages, version 0.1 (C) Sam Jervis, 2004
http://rsp.sourceforge.net/ rsp-contact@lists.sourceforge.net
--------------------------------------------------------------------------------
Retargetable Server Pages (RSP) is a language for writing retargetable web
applications. Programs written in RSP have to be compiled, using the RSP
Compiler, to a target language before they can be deployed on a web server.
Currently RSP supports three target languages, which are:
ASP (Active Server Pages)
JSP (Java Server Pages)
PHP (Hypertext Preprocessor)
Contents
========
Preface
1: Legal Notice
2: Installation
3: Compiling From Source
4: Command Line Interface
5: Ant Interface
6: Compiling the examples
1: Legal Notice
===============
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
2: Installation
===============
To use the RSP Compiler you must jave Java 1.4 installed correctly on your
system. If you wish to build the compiler from sources then you will need
the (larger) Java 1.4 SDK installed, otherwise just the standard runtime
environment is enough.
RSP is normally distributed as a zip file for Microsoft Windows platforms or
as a tarball for Unix platforms. Download whichever is most appropriate for
your system and unzip the contents of the distribtion. It does not matter
where you unzip the distribution, but the conventional locations would be
in C:\Program Files on Windows or in /usr/local on Unix.
In addition to the distribution you will also need to obtain and install the
latest version of ANTLR on your system. ANTLR is available from its website:
http://www.antlr.org/
Once you have installed ANTLR, make sure that antlr.jar is in your CLASSPATH
whenever you use the RSP Compiler. See the Java documentation for more
information about CLASSPATHs.
3: Compiling From Source
========================
To build the RSP Compiler from sources you will need the following to be
correctly installed:
o The Java 1.4 SDK.
o Apache Ant: http://ant.apache.org/
o ANTLR 2.7.4: http://www.antlr.org/
Either place antlr.jar in the Ant lib/ directory, or have it in your
CLASSPATH when you run Ant.
o JUnit 3.8.1: http://www.junit.org
Again, either place junit.jar in Ant's lib/ directory or in your CLASSPATH.
Given these prerequisites you can build the compiler from the root of the
distribution directory using Ant and the build.xml file provided. Use the
command `ant test' to build the compiler and run the unit tests using JUnit.
4: Command Line Interface
=========================
The RSP Compiler can be invoked through a command line interface, although
for serious development work the Ant interface is recommended. The details of
the CLI can be found in the manual. In order to use it you will probably want
to add the distribution root directory to your PATH environment variable.
This will allow you to invoke the compiler through the CLI command `rsp'. On
Unix this is implemented as a shell script, while on Windows it is a batch
file.
5: Ant Interface
================
The preferred means of invocation for the RSP Compiler is through an Apache
Ant build script. For this to work you will need Apache Ant to be correctly
installed, and you will need rsp.jar to be in your CLASSPATH when you invoke
Ant. Please see the manual for more details.
6: Compiling the examples
=========================
The distribution comes with a number of example RSP pages in the examples/
directory. To build them, first set up your environment for using the Ant
interface as described in the previous section. Then from the distribution
root directory use the command `ant _examples' to build the examples.
They will be compiled into subdirectories for all targets supported. For
example, the PHP pages will be compiled into examples/php.
Changes:
