--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/tsrc/fute/readme.txt	Tue May 25 12:34:19 2010 +0300
@@ -0,0 +1,60 @@
+Instructions on how to build functional test MIDlets
+====================================================
+
+This file gives instructions on how to use the build.xml files for MIDlet suite 
+compilation and packing.
+
+
+Requirements
+------------
+
+* Get a local copy of the directory containing the UI FuTe MIDlets from the 
+version control system. Get the whole structure, because the xml files in the 
+root will be needed.
+
+* Apache Ant installed. It is used for compiling the MIDlet source files and 
+packing the classes and resources into MIDlet packages.
+
+* Environment variable JAVA_HOME value is set to the path where JDK is 
+installed.
+
+* Sun Java Wireless Toolkit for CLDC (WTK) installed to "C:\WTK". The location 
+is defined in the file "properties.xml":
+
+    o <property name="wtk.home" value="C:/WTK"/> 
+
+* Java public api classes jar file "java_public_api.jar" should be copied to WTK 
+lib directory, in sub directory "ext". The file can be found i.e. in the SDK 
+package. You can use also some other jar/zip package that contains the needed 
+classes, it is used only for compiling the MIDlets. The location of the file is 
+defined in the file "properties.xml":
+
+    o <property name="java_public_api" value="${wtk.home}/lib/ext/java_public_api.jar"/> 
+
+* Antenna library file should be copied to WTK lib directory, in sub directory 
+"ext". It can be found from the Internet: http://antenna.sourceforge.net/. The 
+location of the file is defined in the file "properties.xml":
+
+    o <taskdef resource="antenna.properties" classpath="${wtk.home}/lib/ext/antenna-bin-1.0.2.jar"/> 
+
+
+Building & packing MIDlets
+--------------------------
+
+Building the MIDlets can be done in the MIDlet project directory itself, or in 
+some of the parent directories. If it is done in the MIDlet project directory, 
+only that MIDlet will be built. If it is done in the root of the UI FuTe 
+MIDlets, then all of them will be built.
+
+The default action for Ant is "pack". It will compile and create the MIDlet 
+packages. Compilation is done by using either one of these commands:
+
+    ant
+    ant pack
+
+If you want to clean the build directories, it can be done with command:
+
+    ant clean
+
+The compiled classes and MIDlets are stored in a directory named "build" to the 
+MIDlet suite project directory.