XML Catalogs 1.1

Annotations, 24 Jun 2021

Editor
Norman Walsh, <>
Abstract:

This document summarizes a set of annotations on the XML Catalogs 1.1 specification.

Status:

Norman Walsh is solely responsible for these annotations. They have not been reviewed by any OASIS Technical Committee and have no normative standing whatsoever.

The following annotations have been added to the XML Catalogs 1.1 specification published at https://xmlcatalogs.org/:

  1. In both tables in 4.1.1 The prefer attribute, the “N/A” entry in column four of row two has been annotated as follows:

    The “N/A” in this cell is a little bit misleading. It’s marked as not applicable because if the external identifier doesn’t specify a system identifier then there can’t be both matching public and matching system entries. If there’s a matching public entry, it will be used, as shown in the first column.

  2. In both tables in 4.1.1 The prefer attribute, the “N/A” entry in column four of row three has been annotated as follows:

    The “N/A” in this cell is a little bit misleading. It’s marked as not applicable because if the external identifier doesn’t specify a public identifier then there can’t be both matching public and matching system entries. If there’s a matching system entry, it will be used, as shown in the second column.

  3. Section 6.1 Common Attributes has been annotated as follows:

    The XML Catalogs specification normatively defines the ID attribute as having the name id. If you’re validating catalogs with the DTD, you must use this attribute. However, this constraint is really imposed by the fact that DTDs and namespace don’t mix. The catalog specification allows attributes from other namespaces, so you could use xml:id attributes instead.

  4. Appendix A, A W3C XML Schema for the XML Catalog has been annotated as follows:

    The simple type defined on line 10 of the schema is flatly wrong. It must include a space or the restriction will reject all public identifiers that contain spaces.

    Lines 10 through 17 should be replaced with the following declaration:

    1  <xs:simpleType name="pubIdChars">
        <xs:restriction base="xs:string">
          <xs:pattern value="[a-zA-Z0-9\-'\(\)+,./:=?;!*#@$_% ]*"/>
        </xs:restriction>
    5  </xs:simpleType>
    
  5. Although not included in the annotations for technical reasons, the editor’s email address is no longer valid. To reach the editor, is your best bet.