DR 10-0036

[Francis Cave]

Resolving DR 10-0036 in the way I have suggested in my previous email will
have an impact upon the resolution of DR 16-0010, which is ‘Closed in COR4’.
This affects §17.5.2.9, §17.5.2.10 and §17.5.2.11. 

 

In the case of §17.5.2.9 the replacement text should read:

 

The value of the val attribute is the name of the glossary document entry to
be displayed.

 

In the case of §17.5.2.10 the replacement text should read:

 

The value of the val attribute is the category of glossary document entries
to be used as the filter.

 

In the case of §17.5.2.11 the replacement text should read:

 

The value of the val attribute is the gallery of glossary document entries
to be used as the filter.

 

Appended below are the suggested edits to §17.5.2.9 through §17.5.2.14. I
have excluded the attribute definition tables and any Notes following these
(indicated by <snip/>), which, except in the cases specified above, are
unaffected by the proposed revisions.

 

Kind regards,

 

Francis

 

 

17.5.2.9 docPart (Document Part Glossary Document Entry Reference)

 

This element specifies the name of the document partglossary document entry
that shall be displayed in the nearest ancestor structured document tag when
its run contents are empty. If this element is specified, then a document
partglossary document entry whose name element (§17.12.12) specifies a name
matching the value of this element, and which belongs to theis of entry type
bbPlcHdr style shall be located to be used as the placeholder text for the
nearest ancestor structured document tag.

 

If no document partglossary document entry is located matching the criteria
specified by this element, then five non-breaking spaces shall be used as
the default placeholder text.

 

[Example: Consider a structured document tag defined as follows:

 

<w:sdt>

  <w:sdtPr>

    <w:placeholder>

      <w:docPart w:val="DefaultPlaceholder_22610170" />

    </w:placeholder>

    


  </w:sdtPr>

  <w:sdtContent>

  


  </w:sdtContent>

</w:sdt>

 

This structured document tag specifies through the docPart element that its
placeholder text must be specified in the document partglossary document
entry of styletype bbPlcHdr whose name is equal to
DefaultPlaceholder_22610170. end example]

 

<snip/>

 

17.5.2.10 docPartCategory (Document Part Glossary Document Entry Category
Filter)

 

This element specifies the category of document partsglossary document
entries that shall be used as the filter when determining the possible
choices of document partsglossary document entries that are displayed for
insertion into the nearest ancestor structured document tag. A document
partglossary document entry category is a sub-classification within a given
document partglossary document entry gallery which can be used to further
categorize the partsentries in a given gallery. [Example: Gallery custom1
might have categories of Legal Clauses, Conformance Clauses, etc. end
example]. The category which shall be used as a filter is stored in this
element's val attribute.

 

If this element is omitted, then the nearest ancestor structured document
tag shall display all document partsglossary document entries in the
specified gallery regardless their specified category. If this element is
present, but no document partsglossary document entries of the specified
gallery and category combination are located by the application, then no
document partsglossary document entries shall be displayed (i.e. the
application shall not fall back to showing document partsglossary document
entries in all categories in the specified gallery).

 

[Example: Consider the following properties for a structured document tag:

 

<w:sdtPr>

  <w:docPartList>

    <w:docPartGallery w:val="custom1"/>

    <w:docPartCategory w:val="Legal Clauses"/>

  </w:docPartList>

</w:sdtPr>

 

This structured document tag specifies that it must present a selection of
document partsglossary document entries for insertion via the docPartList
element (§17.5.2.12) , and those document partsglossary document entries
must only be the partsentries which are in the custom1 gallery via the
docPartType element (§17.5.2.11), and within that gallery, only the document
partsentries which are in a category called Legal Clauses via this element.
end example]

 

<snip/>

 

17.5.2.11 docPartGallery (Document Part Glossary Document Entry Gallery
Filter)

 

This element specifies the gallery of document partsglossary document
entries that shall be used as the filter when determining the possible
choices of document partsglossary document entries that are displayed for
insertion into the nearest ancestor structured document tag. A document
partglossary document entry gallery is a classification of document
partsglossary document entries, which might then be subdivided into
categories. [Example: A gallery with a name of custom1 might have categories
of Legal Clauses, Conformance Clauses, etc. end example]. The gallery which
shall be used is stored in this element's val attribute.

 

If this element is omitted, then the nearest ancestor structured document
tag shall display all document partsglossary document entries in its default
gallery. If this element is present, but no document partsglossary document
entries of the specified gallery are located by the application, then
document partsglossary document entries in the default gallery shall be
displayed (i.e. the application shall behave as if the value was omitted).

 

[Example: Consider the following properties for a structured document tag:

 

<w:sdtPr>

  <w:docPartList>

    <w:docPartGallery w:val="custom1"/>

  </w:docPartList>

</w:sdtPr>

 

This structured document tag specifies that it must present a selection of
document partsglossary document entries for insertion via the docPartList
element (§17.5.2.12), and those document partsglossary document entries must
only be the partsentries which are in the custom1 gallery via this element.
end example]

 

<snip/>

 

17.5.2.12 docPartList (Document Part Glossary Document Entry Gallery
Structured Document Tag)

 

This element specifies that the nearest ancestor structured document tag
shall be of a document partglossary document entry gallery type.

 

This setting does not require or imply that the contents of the structured
document tag shall contain only the exact contents of a document
partglossary document entry of the specified gallery and category which is
present on the current machine, it shall only be used to specify that the
structured document tag is of this kind, which shall be used by an
application to present the possible list of choices for insertion into the
nearest ancestor structured document tag.

 

[Example: Consider the following structured document tag:

 

<w:sdt>

  <w:sdtPr>

    


    <w:docPartList>

    


    </w:docPartList>

  </w:sdtPr>

  


</w:sdt>

 

The docPartList element in this structured document tag's properties
specifies that the type of structured document tag is a document
partglossary document entry gallery. The child elements must specify the
gallery and category filters for this list, if any. end example]

 

[Note: The W3C XML Schema definition of this element’s content model
(CT_SdtDocPart) is located in §A.1. end note]

 

17.5.2.13 docPartObj (Built-In Document Part Glossary Document Entry
Structured Document Tag)

 

This element specifies that the nearest ancestor structured document tag
shall be of a document partglossary document entry type.

 

This setting does not require or imply that the contents of the structured
document tag shall contain only the exact contents of a document
partglossary document entry of the specified gallery and category which is
present on the current machine, it shall only be used to specify that the
structured document tag is of this kind, which shall be used by an
application to present the possible list of choices for insertion into the
nearest ancestor structured document tag.

 

This element differs from the docPartList element (§17.5.2.12) in that it
can be used to semantically tag a set of block-level objects in a
WordprocessingML document without requiring the ability to specify a
category and gallery of objects which can be swapped with it via the user
interface.

 

[Example: Consider the following structured document tag:

 

<w:sdt>

  <w:sdtPr>

    


    <w:docPartObj>

      


    </w:docPartObj>

  </w:sdtPr>

  


</w:sdt>

 

The docPartObj element in this structured document tag's properties specify
that the type of structured document tag is a document partglossary document
entry. The child elements must specify the gallery and category semantics
for this partentry, if any. end example]

 

[Note: The W3C XML Schema definition of this element’s content model
(CT_SdtDocPart) is located in §A.1. end note]

 

17.5.2.14 docPartUnique (Built-In Document Part Glossary Document Entry)

 

This element specifies that this structured document tag is being used to
encapsulate a built-in document partglossary document entry (i.e. this
element appears as a child element of the docPartObj element).

 

[Example: Consider the following structured document tag:

 

<w:sdt>

  <w:sdtPr>

    


    <w:docPartObj>

      


      <w:docPartUnique/>

    </w:docPartObj>

  </w:sdtPr>

  


</w:sdt>

 

The docPartUnique element in this structured document tag's properties
specify that the type of structured document tag is a container for a
document partglossary document entry. end example]

 

This element’s content model is defined by the common boolean property
definition in §17.17.4.

 



This message has been scanned for malware by Forcepoint. www.forcepoint.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.vse.cz/pipermail/sc34wg4/attachments/20190111/9fb32536/attachment-0001.html>