---++ Introduction
Java-Swul is a domain-specific language (DSL) for creating Java SWING
user interfaces. The Java-Swul language is embedded in Java. In this fasion
it provides a concrete syntax for creating SWING objects.
The Java-Swul package enables you to transform Java code with embedded Java-Swul code
to Java code. In this tranformation the Java-Swul is assimilated into the
surrounding Java. Giving you the power of Java with an easy and straightforward
way to create user interfaces.
The Swul part of the name comes from SWING userinterface language
and combined with Java makes Java-Swul. It was first contrived
when developing the MetaBorg method.
---++ Usage
---+++ Read more about usage
* Some JavaSwulExamples are viewable online.
* A real application called JavaJuke, a mp3 jukebox with a Java-Swul programmed interface and ant-build.
* Read the the [[http://www.stratego-language.org/%ATTACHURLPATH%/swul-article.pdf][Java-Swul article]].
---++ How to get it
Java-Swul can be installed from source or from a package.
* [[https://svn.cs.uu.nl:12443/repos/StrategoXT/java-swul/trunk][Source]] can be found in our Subversion server
* [[%DIST%/java-swul-0.1pre9927/][Binaries]] are build by our buildsystem
Java-Swul requires the following packages:
* [[StrategoXT]], a recent version, currently [[%DIST%/strategoxt-0.14/][strategoxt-0.14]]
* [[JavaFront][Java-front]], also a very recent version, currently [[%DIST%/java-front-0.7pre9851/][java-front-0.7pre9851]]
* [[Tools.ATermLibrary][ATerm library]], the stable release will do, currently [[%DIST%/aterm-2.3.1/][aterm-2.3.1]]
* [[Sdf2Bundle][SDF2 Bundle]], the stable release will do, currently [[%DIST%/sdf2-bundle-2.3/][sdf2-bundle-2.3]]
---+++ Some pointers on source compilation
After a checkout from our Subversion server for a source compilation and installation:
* =./bootstrap=
When building Java-Swul from source the following configure parameters might be needed:
* =./configure=
* =--prefix=<dir>=
* =--with-strategoxt=<dir>=
* =--with-java-front=<dir>=
* =--with-aterm=<dir>=
* =--with-sdf=<dir>=
Or when pkg-config is available:
* =./configure=
* =--prefix=<dir>=
After which a normal build and install can be done:
* =make=
* =make install=
---++ Related software
* Java-Swul was grown out of JavaBorg
* JavaFront is used to extend Java
-- Main.ReneDeGroot - 3 Jan 2005