17.16.5.9 COMMENTS

]

[ switches ]

Description: Retrieves, and optionally sets, the comments relating to the current document, as recorded in the Description element of the Core File Properties part or, if field-argument is present, the comments specified by text in field-argument. Specifying a field-argument shall change Description to text.

Field Value: The comments relating to the current document.

Switches: One of the following general-formatting-switches: * Caps, * FirstCap, * Lower, or * Upper.

[Example: Consider the case in which the Description element is as follows:

<Description>Once upon a time, in a land far, far away …</Description>

and the following field is updated:

COMMENTS

The result is:

Once upon a time, in a land far, far away …

Updating the following field:

COMMENTS “I came, I saw, I was not impressed.”

causes the Description element to take on the specified value. end example]

Syntax: