1 files changed, 38 insertions, 0 deletions
diff --git a/odk/examples/java/ConverterServlet/README b/odk/examples/java/ConverterServlet/README
new file mode 100644
index 000000000..ea59b80b4
--- /dev/null
+++ b/odk/examples/java/ConverterServlet/README
@@ -0,0 +1,38 @@
+Servlet for converting documents
+================================
+
+Build preparation:
+==================
+In the file "ConverterServlet.html", search for the following line:
+<form action="http://localhost:8080/conversion/servlet/ConverterServlet" method=post enctype="multipart/form-data">
+Replace the existing IP address (localhost) with your intended IP address.
+
+Installation instructions:
+==========================
+1. If no web server is available you should install your favourite web server.
+   The example was tested with a Tomcat 4.1 server (http://jakarta.apache.org/tomcat/)
+2. Download the servlet support Java archive (cos.jar) from 
+   http://www.servlets.com/cos/index.html and copy the file to the directory 
+   <OFFICE_HOME>/program/classes. If you don't use the created WAR (WAR = simple web archive file, it 
+   is similar to a normal Jar file) file, please make these classes also known to your web server.
+3. You need also the Servlet API (servlet.jar). The Tomcat server comes with this Servlet API. Please
+   copy the file "servlet.jar" to the directory <OFFICE_HOME>/program/classes.
+   If you don't use the Tomcat server, make sure that the Servlet API is in the classpath of your web 
+   server. You can download the Servlet API from http://java.sun.com/products/servlet/index.html . 
+4. Use your GNU make (http://www.gnu.org) to build the servlet class.
+5. Make the servlet class known to your web server.
+   The example creates also a WAR file which can be easy deployed in a Tomcat server.
+   5.1 Browse the 'Tomcat Web Application Manager'
+   5.2 Navigate into the section 'Upload a WAR file to install'
+   5.3 Browse to your generated WAR file and select it
+   5.4 install it
+
+  
+Converting documents with the servlet:
+======================================
+1. Browse your web server "http://<your_ip>/conversion/ConverterServlet.html" or
+   open the file "ConverterServlet.html" in your web browser and select a file.
+2. Select a type to convert the file to, and the extension for the converted file.
+3. Press the button. The document will be uploaded to the server, converted and
+   pushed back to the client. Your browser will open a dialog for saving the
+   converted document.