Jostraca Git
Brought to you by:
rjrodger
Menu
▾
▴
Tree [8e2beb] master / History
rjrodger
Richard Rodger
Read Me
Jostraca 0.4.1 README
---------------------
Copyright (c) 2000-2006 Richard Rodger
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., 675 Mass Ave, Cambridge, MA 02139, USA.
--------------------------------------------------------------------
Welcome to Jostraca!
To install please read the INSTALL.txt file which gives detailed
instructions and a quick summary of the installation procedure.
If you wish to submit a bug report please visit the web site at
http://www.jostraca.org/bugs/buglist.htm or send an email to
bugs@jostraca.org
For comments and suggestions visit
http://www.jostraca.org/contact.htm or send an email to
comments@jostraca.org
For help and documentation see the doc folder included in this
distribution or visit http://www.jostraca.org/documentation.htm
Read the faq at http://www.jostraca.org/faq.htm or join the mailing
lists at http://www.sourceforge.net/projects/jostraca
WARNING! This is free (beer and speech) software - it may completely
destroy everything on your system. Use only in a test environment
until you are sure you know what you are doing. While the software
has been tested this is no guarantee of anything. THIS SOFTWARE IS
SUPPLIED COMPLETELY "AS IS". USE AT YOUR OWN RISK.
Thanks for your support!
The Jostraca Team
--------------------------------------------------------------------
A Brief Introduction
Jostraca is a code generation toolkit written in Java. It can solve
any code generation problem because it uses existing languages to
build the code. In much the same way that JSP and ASP build HTML,
Jostraca allows any language to build any other language (with a bit
of work, of course :).
Templates are used to create a JostracaCodeWriter program which then
writes the generated code. This system is inherently flexible
because you can hack it at any point to your own needs.
--------------------------------------------------------------------
Installation
Please read the INSTALL.txt file for full instructions.
Quick Summary:
1. Unpack the distribution.
2. cd into the distribution folder (jostraca-x.y.z).
On Windows, run the command 'setup'.
On Unix, run the command 'sh setup.sh'.
3. To check the installation, run the command: 'jostraca -check'
--------------------------------------------------------------------
Documentation
Documentation supplied with the distribution can be found in the doc
subfolder. Open README.htm to get started. Visit the site
http://www.jostraca.org for updates and mailing lists. Contributions
to the documentation (extra tutorials and articles) are especially
welcome - email info@jostraca.org.
--------------------------------------------------------------------
Upgrading from Previous Releases
Release 0.3.x:
Simply follow the installation instructions.
Release 0.2.x:
Simply follow the installation instructions. There are no syntax
changes between the 0.2 and 0.3 releases.
Release 0.1.0a:
Jostraca 0.2 can still use version 0.1 templates, although the
syntax has changed. You may experience some minor difficulties.
Rename any 'jostraca.bat' batch files or 'jostraca' shell scripts
that are currently in use, so that they will not conflict with the
new versions. There is no need to delete the old installation - just
rename the Jostraca home folder to something like:
jostraca-0.1.0a-off. This way you can reactivate it if necessary.
Downgrading to Previous Releases
Follow the installation instructions for the given release.
--------------------------------------------------------------------
Obtaining the Latest Release
The latest release is always available from http://www.jostraca.org
by HTTP download. Jostraca is not available by FTP.
--------------------------------------------------------------------
Credits
This project is still in an initial development phase so
contributions, suggestions and criticism are always welcome.
Orla Shanaghy provided technical and editorial assistance with the
documentation.
Derek Conniffe helped build the server and suffered numerous daft
hardware questions (which way does the motherboard go?).
Lars Grammel wrote the ant task.
Tim Buchalka wrote the build.xml file.
Chris Perdue wrote the CommandRunner component.
Richard Rodger wrote the original version and maintains the code.
Bug Reports:
Mitko Ruerup
Romeo Kienzler
Parag Alurkar
Reviewers:
Eoin Shanaghy
Paul Denby
Godfrey Nolan
Alaister Moull
Conor Wyse
--------------------------------------------------------------------