XSD bundle: udsxml2tex/odx/xsd
===============================

The XML Schema files in this directory (odx-d.xsd, odx-c.xsd, odx-cs.xsd,
odx-v.xsd, odx-e.xsd, odx-f.xsd, odx-fd.xsd, odx-m.xsd) are NOT a copy of
the ASAM ODX 2.2.0 reference schemas. They are minimal lenient structural
schemas written from scratch for the udsxml2tex project. They check only
that:

  1. The root element is <ODX> (optional MODEL-VERSION attribute).
  2. The root contains a single category-specific top-level child element
     (DIAG-LAYER-CONTAINER, COMPARAM-SPEC, COMPARAM-SUBSET, VEHICLE-INFO-SPEC,
     FLASH, FUNCTION-DICTIONARY-SPEC or MULTIPLE-ECU-JOB-SPEC).
  3. Any descendant content is permitted (xsd:any processContents="skip").
  4. Any attributes are permitted (xsd:anyAttribute processContents="skip").

Limitations
-----------

These schemas catch high-level structural mistakes such as missing or wrong
root elements but they do NOT enforce the full ODX 2.2.0 grammar. They are
intentionally lenient so that valid output from the udsxml2tex serializers
passes validation while obviously broken documents (wrong category, missing
root, etc.) are still rejected.

License
-------

The udsxml2tex-authored XSDs in this directory are released under the same
MIT license as the parent udsxml2tex project. See the top-level LICENSE
file in the repository root for the full text.

Upgrading to the full ASAM XSDs
-------------------------------

To upgrade to the full ODX 2.2.0 grammar:

  1. Obtain the official ASAM MCD-2 D 2.2.0 XSD bundle (ODX-2.2.0.xsd
     and its dependencies). ASAM distributes these under a separate
     license; review the terms before redistributing them inside the
     udsxml2tex source tree or wheel.
  2. Replace odx-d.xsd, odx-c.xsd, odx-cs.xsd, odx-v.xsd, odx-e.xsd,
     odx-f.xsd, odx-fd.xsd and odx-m.xsd with the appropriate ASAM
     XSDs (and any imports they require).
  3. The validator (udsxml2tex/odx/xsd_validator.py) discovers schemas by
     filename via ODX_CATEGORY_SUFFIX, so no Python changes are required.
  4. Update pyproject.toml [tool.setuptools.package-data] to include any
     additional XSD imports the official bundle requires.
