Set a comment at the XML document level

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
status = %XML_DOC_SETCOMMENT(document, comment)

Return value


XML_SUCCESS if a comment is set.



The XML document instance to set a comment for. (XML_DOC_TYPE)


The comment string to set. (a)


Comments are hidden from the end user when the output document is displayed. A comment in an XML document has the format


%XML_DOC_SETCOMMENT adds the opening and closing characters (“<!‑‑” and “‑‑>”, respectively) for you; the comment argument should only include the text of the comment.

Note the following restrictions:

This function is defined as ^VAL.


The function

status = %xml_doc_setcomment(document,"this is my comment")

sets a comment that looks like this:

<!--this is my comment-->