7 Location address module

7.9.1 Identified local element or entity

A reference can be made directly to an element in the same document that has an ID attribute simply by specifying the ID. A location address element is not needed in such a case. A reference can be made directly to an entity declared in the same document by naming the entity.

7.9.2 Property location address

The element form property location address (proploc) addresses the value of the property of a node in a grove by property name. The location source of a property location address is the node or nodes that exhibit the property whose value is addressed. The property is named in the content of the proploc element.

The attribute additional property source (apropsrc) specifies whether the processor should examine the origin ancestry of the location source (starting with the location source's origin) for the property named in the content of the property location if it is not exhibited by the location source (apropsrc) or whether the location source is the only source for the property (solesrc).

NOTE 178 For example, if the property is "elements", the location source is the document element of an SGML document, and the additional property source value is "apropsrc", the HyTime engine will use the elements property exhibited by the SGMLDOC node, which is the origin of the document element node.

The attribute not an applicable property (notprop) specifies the treatment of a proploc when the property named is not exhibited by the location source or (if specified) its additional property source. The proploc can be treated as an RHE ("error") or it can be ignored ("ignore").

7.9.3 Name-space location address

The element form name-space location address (nmsploc) addresses nodes in named node lists. The location source for a name-space location address must be a node that exhibits (or whose additional property source exhibits) a named node list property. The name-space location address selects nodes from the value of the named node list property.

NOTE 180 In other words, a name-space location address includes an implicit property location that addresses the value of the specified named node list property.

7.9.4 Mixed location address

The element form mixed location address (mixedloc) addresses objects by containing other location address elements. Thus a mixedloc is equivalent to putting an ID on each contained location address element and creating a name-space location address whose name list lists those IDs (and only those IDs) and whose location source is the SGMLDOC node of the grove for the document in which the mixedloc occurs.

                   <!-- Mixed Location Address -->
<![ %mixedloc; [
<!element
   mixedloc       -- Mixed location address --
                  -- Clause: 7.9.4 --
                  -- Groups location addresses together. --
   - O
   (%loc;)*

-- OptionalAttributes [locs]: multloc, spanloc, treetype --
-- CommonAttributes [GenArc]: dafe, dvlatt, etfullnm, id,
   ireftype, lextype, opacity --
-- CommonAttributes [base]: activity, conloc, dtxtatt, valueref --
-- CommonAttributes [locs]: refctl, refloc, reftype, rflocspn --
>
]]><!-- mixedloc -->

7.9.5 Named location address

7.9.6 Name list specification

The element form name list specification (nmlist) contains an undelimited SGML attribute value specification for a name list. The nmlist form is derived from the nmsploc form.

There is no limit on the number of names. The names are derived from the name list attribute value specification in the manner defined by ISO 8879.

NOTE 182 Leading and trailing separators are ignored, and intervening ones are reduced to a single space, resulting in a space-delimited name list.

The attribute name type (nametype) indicates whether the names in the list are entity names or element IDs. (The nametype attribute is a synonym for the namespc attribute of the nmsploc element form.)

If the name specification list is empty, it is considered to address the SGMLDOC node of either the document named by the docorsub attribute, if specified, or the document in which the nmlist occurs.

NOTE 183 Support of the "queryloc" option is not required for this purpose.

The attribute SGML document or subdocument (docorsub) identifies the SGML document entity of the SGML document, or the SGML subdocument entity of the SGML subdocument, in which the names in the name list are defined. Unless the "anysgml" option is supported, the specified document or subdocument, and the document in which this element occurs, must be subject to equivalent SGML declarations. (The docorsub attribute is a synonym for the locsrc attribute from the location source attribute list.)

                   <!-- Name List Specification -->
<![ %nameloc; [
<!element
   nmlist         -- Name list specification --
                  -- Clause: 7.9.6 --
                  -- Addresses elements or entities in an SGML document --
   - O
   (#PCDATA)      -- Reference --
                  -- Lextype: (IDREF|ENTITY)* --

-- Attributes [locs]: nmlist, proplat, locsrc, impsrc --
-- OptionalAttributes [locs]: multloc, referatt, spanloc, treetype --
-- CommonAttributes [GenArc]: dafe, dvlatt, etfullnm, id,
   ireftype, lextype, opacity --
-- CommonAttributes [base]: activity, conloc, dtxtatt, valueref --
-- CommonAttributes [locs]: refctl, refloc, reftype, rflocspn --
>
<!attlist
   nmlist         -- Name list specification --
                  -- Clause: 7.9.6 --

   HyBase   NAME     #FIXED nmsploc
   impsrc   NAME     #FIXED grovert
   HyBnames CDATA    #FIXED "locsrc docorsub
                             namespc nametype
                                #MAPTOKEN elements element
                                #MAPTOKEN entities entity"

   nametype       -- Name-space from which nodes are selected --
      (entity|element)
      entity

   docorsub       -- Document or subdocument location source --
      ENTITY
      #IMPLIED

   notspace       -- If nmspace name is invalid? --
      NAME        -- Lextype: ("ERROR"|"IGNORE") --
      ERROR

   notname        -- If name is not valid in nmspace? --
      NAME        -- Lextype: ("ERROR"|"IGNORE") --
      ERROR
>
<!entity % proplat "INCLUDE">
<!entity % locsrc "INCLUDE">
<!entity % impsrc "INCLUDE">
]]><!-- nameloc -->