Including and excluding comments

By default, all comments from source documents are included in the result document. Therefore, you do not need to do anything special to preserve comments. In the following example, the result document contains the comments from doc2, doc3, and doc4.

Example: Preserving comments

<PDF result="doc1">

	<PDF source="doc2"/>

	<PDF source="doc3"/>

	<PDF source="doc4"/>

</PDF>

Comments remain associated with the pages on which they appear in the source document. The following example assembles a subset of pages from doc2. Any comments (or other annotations) associated with pages that are not included do not appear in the result.

Example: Assembling a subset of pages

<PDF result="doc1">

	<PDF source="doc2" pages="1-5"/>

	<PDF source="doc2" pages="10-15"/>

</PDF>

To exclude comments from the pages in a source element, use the NoComments element.

Example: Removing comments from a source document

<PDF result="doc1">

	<PDF source="doc2"/>

	<PDF source="doc3">

		<NoComments/>

	</PDF>

	<PDF source="doc4"/>

</PDF>

In the example above, comments from doc2 and doc4 are included in the result document; comments from doc3 are not included.

Note: The NoComments element removes annotations in addition to those referred to as comments. It removes all annotation types (including 3D and multimedia, for example), with the exception of Link annotations (which can be removed by the NoLinks element) and Widget annotations.

In the following example, because the NoComments element is a child of the PDF result element, none of the comments in its scope are included.

Example: Removing all comments

<PDF result="doc1">

	<PDF source="doc2"/>

	<PDF source="doc3"/>

	<PDF source="doc4"/>

	<NoComments/>

</PDF>

In the following example, the NoComments element is a child of a PDFGroup element. Therefore, no comments are included from the source documents within the PDFGroup element. Only the comments from doc4 are included in the result.

Example: Removing comments from a group of sources

<PDF result="doc1">

	<PDFGroup>

		<PDF source="doc2"/>

		<PDF source="doc3"/>

		<NoComments/>

	<PDFGroup/>

	<PDF source="doc4"/>

</PDF>

NoComments and Comments cannot be siblings.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/livecycle/8.2/ddxRef/000652.html

Add Comment