***************************************************
* How to internationalize X-Application Generator *
***************************************************

1. Inflate the xapplication_i18n_patch.zip file to your xapplication root directory.

2. Replace the tag <DecodeInterceptor /> in [TOMCAT_HOME]\conf\server.xml
   by the following defintion changing 
   
   <DecodeInterceptor defaultEncoding="UTF-8" debug="1"/> 
   
3.  Replace the file serverXapp8081.xml in [TOMCAT_HOME]\conf by the one delivered 
    with this update (stored in subdirectory /template/generatorGui).  

4. Open a console window change to the directory [XAPLLICATION_HOME] and execute the command "build quick"
   followed by the command "build generator".
   NOTE: Tomcat must not be running, while those commands are executed.

5. Load Schema into Tamino via Tamino Interactive Interface. Currently it is not possible to load 
   Schema defintions containing special characters via the X-Application Generator
      
NOTE:

Having done these steps the X-Application Generator can be used to generate 
applications for every possible encoding as long as the Schema is already defined
within Tamino. Thus it is currently not possible to use the remote mode of X-Application Generator.

To generate an application for a Schema having special characters in the root element, an
target directory has to be specified explicitly. So that the X-Application Generator does
not use the doctype as the default name for the generated web application directory. This is
due to the fact that special characters cause trouble when used as file or directory names.

Since the exchange of parameters between X-Application Generator and Tamino X-Plorer is performed
via URL and special characters in URL parameters are not transferred correctly, it is not possible
to use Tamino X-Plorer to generate or start applications using special characters in the doctype
or the collection name. Applications with special characters in subelement names cause no problems.  



************************************************************************************
* How to internationalize an existing web application generated with X-Application *
************************************************************************************

1. Replace the file JavaTaminoAPI.jar in [WEBAPP_DIR]\WEB-INF\lib with the one
   delivered with this update (for example in the subdirectory /prerequisites/lib/debug).
   
2. Replace the tag <DecodeInterceptor /> in [TOMCAT_HOME]\conf\server.xml
   by the following defintion
   
   <DecodeInterceptor defaultEncoding="UTF-8" debug="1"/> 
   
3. Edit the charset attribute of the JSP page command in all JSP pages 
   specifying the encoding "UTF-8".
   
   For example:
      <%@ page language="java" contentType="text/html; charset=UTF-8"  errorPage="Error.jsp"%>
      
4. If a meta tag is specified, change the encoding there as well.

   For example:
      <meta http-equiv="Content-Type; charset=UTF-8" content="text/html"/>
      
5. Restart Tomcat.

After performing these steps your application accepts special characters in input and display fields.