One or more configuration files are used to configure a JSF
application. The main configuration file for an application is the
WEB-INF/faces-config.xml file. Files in the same
format can be bundled also within JAR files containing custom
components, renderers, or any other custom JSF classes. See Chapter 13 and the description of the
FactoryFinder class in Appendix D for details.
This appendix describes all elements that can be used in a JSF configuration file. The configuration file is an XML file, with the rules for which elements it can contain and how they must be arranged controlled by Document Type Definition (DTD) available online at http://java.sun.com/dtd/web-facesconfig_1_0.dtd. This DTD must be referenced in the document type declaration at the top of the configuration file, as shown in Example E-1.
<!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" "http://java.sun.com/dtd/web-facesconfig_1_0.dtd"> <faces-config> ... </faces-config>
All other elements in the configuration file must be enclosed within
<faces-config> element as shown in
<faces-config> element body, top-level elements can be included in any order. Each top-level element is described in a separate section in this appendix. The top-level elements are all optional and can be included more than once, unless otherwise stated. Most top-level elements contain other elements. ...