A.4 Property Set Definition Requirements (PSDR)

A.4.2.1 Shared constructs

A property set is composed of "property set components": classes, properties, normalization rules (for comparing string property values), and enumerated values (of properties). A property set definition, therefore, consists of property set component definitions. Syntactically, each property set component definition is an element; the type of the element is determined by the type of property set component it defines.

Several attributes are provided by more than one property set component definition element type. These attributes have to do with the naming of components, and with the specification document that describes the components. There are also two descriptive element types that are used in the definitions of multiple types of components.

A.4.2.2 Modules

Sets of property set components may be grouped together as children of elements of type property set module (psmodule), so that they may be included or excluded from grove plans as a group. Property set components occurring outside of modules are required in every grove plan; they are automatically included in and may not be excluded from any grove plan.

NOTE 458 Uses of normalization rules, which are not affected by grove plans, are also not affected by whether they are defined within or outside of modules.

The attribute modules depended on (dependon) identifies modules whose components must be included in any grove plan in which a component of this module is included. Dependencies of depended-on modules are also considered depended upon by a module, though they need not be explicitly named in the value of the module's dependon attribute.

                     <!-- Property Set Module -->
<!element
   psmodule       -- Property set module --
                  -- Clause: A.4.2.2 --
   - O
   ((desc|note)*,(classdef|propdef|normdef)*)

-- Attributes: appnm, default, fullnm, psmodule, rcsnm --
>
<!attlist
   psmodule       -- Property set module --
                  -- Clause: A.4.2.2 --

   dependon       -- Modules depended on --
      NAMES       -- Constraint: RCS names of modules defined in this
                     property set --
      #IMPLIED    -- Default: none --
>

A.4.2.3 Class definition

An element of type class definition (classdef) defines a class of node.

NOTE 459 The rcsnm attribute of classdef has the semantics defined for the rcsnm attribute list form. It is redefined here so that the rcs names of class definitions can be SGML unique identifiers, allowing SGML processors to verify that references to class names are valid.

The attribute content property (conprop) identifies the content property of the class.

The attribute prune content tree (prune) specifies whether when the class is omitted from a grove plan, the content trees rooted at nodes of the class in a complete grove are pruned away, or whether that branch is merely "grafted" by replacing the node in its parent's children property with the node's children.

The attribute data separator property (dsepprop) identifies the data separator property of the class.

The attribute may add (mayadd) is used by the DSSSL transformation language. It is fully described in the DSSSL standard.

NOTE 460 A rule of thumb for its use is that specifying "mayadd" on a class definition indicates that nodes of that class represent information about aspects of the representation of the grove in source form that can be automatically managed by the process that converts the grove into source form.

                      <!-- Class Definition -->
<!element
   classdef       -- Class definition --
                  -- Clause: A.4.2.3 --
   - O
   ((desc|note)*, propdef*)

-- Attributes: appnm, clausnot, default, fullnm, spec --
>
<!attlist
   classdef       -- Class definition --
                  -- Clause: A.4.2.3 --

   rcsnm          -- Name in RCS --
      ID          -- Constraint: unique in component name space --
      #REQUIRED

   conprop        -- Content property --
      NAME        -- Constraint: RCS name of nodal property of class
                     with noderel=subnode, char property, or string --
      #IMPLIED    -- Default: no content property --

   prune          -- Prune content tree --
      (prune|nprune)
                  -- Constraint: can only be nprune if the set of
                     allowed classes of the content property is
                     guaranteed to be a subset of that of parent's
                     content property --
      prune

   dsepprop       -- Data separator property --
      NAME        -- Constraint: RCS name of char or string property
                     of class --
      #IMPLIED    -- Default: none --

   mayadd         -- May add --
      (mayadd|mayntadd)
      mayntadd
>

A.4.2.4 Property definition

An element of type property definition (propdef) defines a property.

The attribute class name (cn) identifies the provider of the property. Its value must be the RCS name of a class defined within the same module, within one of that module's depended on modules, or outside the scope of any module. If the property definition occurs within the content of a class definition, the specification of class name may be omitted; such omission implies that the property is provided by the class within whose definition the property's definition occurs.

A.4.2.5 Normalization rule definition

The element type normalization rule definition (normdef) defines a string normalization rule by referring to it in a specification document.

                <!-- Normalization Rule Definition -->
<!element
   normdef        -- Normalization rule definition --
                  -- Clause: A.4.2.5 --
   - O
   (desc|note)*

-- Attributes: appnm, clausnot, fullnm, rcsnm, spec --
>