Syntax

creating (sgml-dtds | xml-dtds) {key}

The creating option of do sgml-parse or do xml-parse compiles a DTD and stores it on the sgml-dtds or xml-dtds shelf. The compiled DTD will only be added if no errors occurred during parsing.

When creating is specified, the parsing terminates at the end of the document prolog, and the document instance is not parsed.

If the sgml-dtds or xml-dtds shelf does not already have such an item, a new item, with the given key, will be created and added to the end of the shelf, and the newly compiled DTD is stored in that item. If the sgml-dtds or xml-dtds already has an item with the given key, then the newly created DTD replaces the previous one.

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

The sgml-dtds or xml-dtds shelves are special shelves, and are not accessible in the same way as other shelves. You cannot use the following keywords with these shelves:

• remove
• using
• lastmost
• item of
• repeat over
• key of
• number of

Related Syntax    do sgml-parse    do xml-parse

Related Concepts    SGML DTDs: creating    XML DTDs: creating

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