When the do xml-parse action specifies creating xml-dtds and a key, it terminates parsing at the end of the XML document prolog, creates a "compiled" DTD, and saves it in the specified item of the xml-dtds shelf. The saved xml-dtds item can be used later to parse an instance or instance part.

If the xml-dtds shelf doesn't already have such an item, a new item with the given key is added to the end of the shelf, and the newly compiled DTD is stored in that item. If the xml-dtds shelf already has an item with that key, the newly created DTD replaces the previous one.

The new xml-dtds item is not created until the entire do xml-parse action has completed. If there is an error in the prolog (DTD), the xml-dtds shelf item will not be created or updated.

All the usual markup rules are processed when the DTD is parsed. This allows information in processing instructions associated with the DTD, for example, to be captured by the program.

Note that the input to a do xml-parse can include a document, although it is not necessary. If there is a document instance, it is not parsed when input is used to create a DTD in this way.

Related Syntax    creating    do xml-parse

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]