Documentation for XML Software Autoupdate DTD

Version: 1.00
Creator: Lars Marius Garshol
PublicId: -//LM Garshol//DTD XML Software Autoupdate 1.0//EN//XML

Description

The XSA DTD is intended for marking up a list of products produced by the same creator (software vendor, organization, individual) and giving a concise description of their current status.

Root elements

Element index

changes Changes since last release.
email The email address of the vendor.
info-url Home page of product.
last-release The date of the last release.
name The name of a vendor or a product.
product Information about a software product.
url The home page URL of the vendor.
vendor Contains information about the vendor whose products are described in this document.
version The current version of the product.
xsa The root element.

Attribute index

Element descriptions

changes

Changes since last release. This should describe the changes since the last release of the product, so that interested parties know whether the new release is of interest or not and what it contains. This element should contain only plain text.

Parents

product

Content model

ANY

email

The email address of the vendor. This should be a valid email address to which requests regarding the products listed in the document should be sent.

Parents

vendor

Content model

(#PCDATA)*

info-url

Home page of product. This should contain the URL of a web resource with more information about the product, preferably the home page of the product.

Parents

product

Content model

(#PCDATA)*

last-release

The date of the last release. This should contain the date of the last release of the product, in YYYYMMDD format.

Parents

product

Content model

(#PCDATA)*

name

The name of a vendor or a product. In both cases, this is intended to be the official name by which the vendor or product is known.

Parents

product vendor

Content model

(#PCDATA)*

product

Information about a software product. This element is a container element which contains information about a single software product.

Parents

xsa

Content model

(name , version , last-release , info-url? , changes?)

Attributes

Name Type Declaration Default Description
id ID #REQUIRED A unique identifier for this product, within the XSA document. This attribute is used to refer to the product from outside the document and must remain stable.

url

The home page URL of the vendor. This should be a valid URL, to which people can turn to get more information about the creator of the products listed in the document.

Parents

vendor

Content model

(#PCDATA)*

vendor

Contains information about the vendor whose products are described in this document. This is just a container element and does not have any special significance. The information here applies to all products.

Parents

xsa

Content model

(name , email , url?)

version

The current version of the product. This should contain the current version of the product. Products which do not have explicit version numbers should use something like '12.Jul.99 release' to distinguish releases.

Parents

product

Content model

(#PCDATA)*

xsa

The root element. This is simply used to hold the XSA data inside one element, and has no special semantic significance.

Parents

Must appear as the root element.

Content model

(vendor , product+)

Attributes

Name Type Declaration Default Description
version CDATA #FIXED 1.0 The version of the XSA specification that this XSA document adheres to.

Produced by dtddoc.py, using xmlproc.