[Myfaces Wiki] Update of "Installation and Configuration" by Andy Phillipson

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The following page has been changed by Andy Phillipson:
http://wiki.apache.org/myfaces/Installation_and_Configuration

------------------------------------------------------------------------------
+ == Using Tomahawk without an Internet connection (and with the Sun RI) ==
+ 
+ The tomahawk.jar file contains META-INF/faces-config.xml with a PUBLIC reference to web-facesconfig_1_1.dtd.  This causes the DTD to be referenced from java.sun.com during application server startup (tested on Apache Tomcat 5.x but may apply to other servers as well).  This problem manifests itself as follows (in this case, taken from the Apache Tomcat log file):
+ 
+ "javax.faces.FacesException: Can't parse configuration file:jar:file:/<web-context-path>/WEB-INF/lib/tomahawk.jar!/META-INF/faces-config.xml"
+ 
+ A work-around for this problem is as follows:
+ 
+  * Add META-INF/web-facesconfig_1_1.dtd to tomahawk.jar (obtain the file from http://java.sun.com/dtd/web-facesconfig_1_1.dtd).
+  * Modify the header of faces-config.xml to reference the DTD from the same directory that contains faces-config.xml (META-INF) as follows:
+ {{{
+      <!DOCTYPE faces-config SYSTEM "web-facesconfig_1_1.dtd">
+ }}}
+ 
+ 
  == Orion 2.0.2 ==
  
  See ["Make it work with Orion application server"]