FpML 4.2 Working Draft - Readme file
=====================================

The "xml" directory contains the following:

fpml-XXX-4-2.xsd : schema files, as follows:
fpml-main-4-2.xsd - root definitions.
fpml-doc-4-2.xsd - trade definitions and definitions relating to validation.
fpml-shared-4-2.xsd - shared definitions used widely throughout the specification. These include items such as base types, shared financial structures, etc.
fpml-enum-4-2.xsd - shared enumeration definitions. These definitions list the values that enumerated types may take.
fpml-asset-4-2.xsd - underlyer definitions plus some types used by these (e.g. ones relating to commissions or dividend payouts).
fpml-msg-4-2.xsd - definitions related to messaging and workflow.
fpml-ird-4-2.xsd - Interest rate derivative product definitions.
fpml-fx-4-2.xsd - Foreign exchange product definitions.
fpml-cd-4-2.xsd - Credit derivative product definitions.
fpml-eqd-4-2.xsd - Equity Option and Equity Forward Product Definitions.
fpml-eqs-4-2.xsd - Equity Swap Product Definitions.
fpml-eq-shared-4-2.xsd - Definitions shared by types with Equity Underlyers.
fpml-valuation-shared-4-2.xsd  Definitions used throughout the pricing and risk schema, such as quotations characteristics, measure types, etc.
fpml-valuation-4-2.xsd  Valuation result sets and related definitions.
fpml-reporting-4-2.xsd  Messages used for requesting and providing valuation reporting results.
fpml-mktenv-4-2.xsd  Definitions of market environment data structures such as yield curves, volatility matrices, and the like.
fpml-riskdef-4-2.xsd  Definitions of valuation and sensitivity results. They include detailed definitions of sensitivity calculations and are intended to be used by sophisticated users.
fpml-pretrade-4-2.xsd - Pre-trade messages components.
fpml-tradeexec-4-2.xsd - Trade execution messages components.
fpml-posttrade-4-2.xsd - Post-trade messages components.

Plus, the xml directory contains subdirectories for each subset of the 
FpML standard, namely:

cd - credit derivatives
eqd - equity derivative options
eqs - equity derivative swaps
eqvs - equity variance swaps
fx - foreign exchange
ird - interest rate derivatives
msg - messaging
pr - pricing and risk


Each subdirectory contains a number of example files.  These files are named as follows:
YY40_exNN_long_description.xml, 
where
YY is the subset identifier and
NN is an integer number.

The examples have a schemaLocation attribute that references their parent 
directory.  In other words, the FpML schema much be present in the parent 
directory of the example file for the example file to validate using the 
schemaLocation attribute.

The schemaLocation attribute previously referenced the examples own directory, 
and extra copies of the schema files were placed in each example directory.
This simplified validation of the examples and helped certain tools to work
properly, but caused some users confusion.

The examples have been validated using Xerces J v 2.4.1.

