Getting Started documentation for upcoming Release 1.1Binary DistributionThe top-level structure of the install image is:
ChangeLog.txt
DISCLAIMER.txt
LICENSE.txt
LICENSE_THIRD_PARTY.txt
NOTICE.txt
NOTICE_THIRD_PARTY.txt
README.txt
RELEASE_NOTES.txt
bin/
examples/
lib/
binding-c/
binding-csharp/
binding-java/
uninst.exe (for windows use only)
Please take a moment to review the RELEASE_NOTES.txt, ChangeLog.txt and The Windows installer (apache-etch-1.1.0-incubating-setup.exe) has created a apache-etch-1.1.0-incubating-windows-x86-bin.zip or apache-etch-1.1.0-incubating-linux-x86-bin.tgz you will want to create this environment variable yourself: windows: set ETCH_HOME=C:\Program Files\Apache Software Foundation\apache-etch-1.1.0 *nix: export ETCH_HOME=/path/to/apache-etch-1.1.0 The bin directory has also been put on your path by the Windows installer. If windows: PATH %PATH%;%ETCH_HOME%\bin *nix:
export PATH="$PATH:$ETCH_HOME/bin"
The bin/ directory contains a Windows bat script and a unix shell script. You will also need to have a java runtime installed (later versions of sun jre After the installer has been run and the environment setup, at a windows windows: C:\>etch -v Etch version is Apache Etch 1.1.0-incubating (some build info) unix: bash-3.2$ etch -v Etch version is Apache Etch 1.1.0-incubating (some build info) The lib directory contains the various jar files for the compiler and the Apache Velocity dependency jar: apache-etch-java-compiler-1.1.0-incubating.jar apache-etch-java-compiler-1.1.0-incubating-src.jar ... The top level folders binding-c, binding-java and binding-csharp contain the language specific Binding for Javabinding-java is organized as follows: apache-etch-java-runtime-1.1.0-incubating-src.zip lib/ apache-etch-java-runtime-1.1.0-incubating.jar The generated java source from the etch compiler needs apache-etch-java-runtime-1.1.0-incubating.jar. Binding for C#binding-csharp is organized as follows: apache-etch-csharp-runtime-1.1.0-incubating-src.zip lib/ ApacheEtchCsharpIncubating.dll ApacheEtchCsharpIncubating.pdb The generated c# source from the etch compiler needs ApacheEtchCsharpIncubating.dll Binding for Cbinding-c is organized as follows: bin/ apr-1-config (on linux) apriconv (on linux) include/ [etch-*].h (on win32) apr-1 (on linux) lib/ etch.lib (on win32) etch.pdb (on win32) libetch.a (on linux) extern/ apr/ bin/ libapr-1.dll (on win32) libapr-1.pdb (on win32) libapriconv-1.dll (on win32) libapriconv-1.pdb (on win32) iconv/ [iconv*]-stuff include/ [apr-*].h lib/ libapr-1.lib (on win32) libapriconv-1.lib (on win32) libapr-1.so (on linux) libapriconv-1.so (on linux) apache-etch-c-runtime-1.1.0-incubating-src.zip Generated C source depends on the dlls/so/a/h files mentioned above. The best choice to Ant PluginThere is an ant plugin which you can use with ant 1.7.0 or later to invoke the MavenIf you are using maven, then you might want to install the Etch artifacts into etch-maven-install.bat You need to have maven on your path when you run this script. The file Python and XML BindingsThe source distribution includes code to support XML and python bindings, but ExamplesExamples have been provided in the examples/ subdirectory. Start with the HelloWorld TestsUnit tests can be had by checking out the source code from the subversion http://svn.apache.org/repos/asf/etch/releases/release-1.1.0-incubating HelpFor help, see the wiki or send email to user@etch.apache.org. See |