6.2. The "Resources" dialog box

This dialog box is automatically displayed during a File|Save As operation when the document to be saved has resources which are logically part of this document.

There are 3 types of resources:

For each resource, there are 3 possible actions:

Ignore

The reference to the resource is the same in the original and in the saved document.

Example: if document /docs/docA.xml having resource images/icon.png is to be saved as /newdocs/docB.xml. icon.png will not be copied to newdocs/ and docB.xml will have the same reference to the resource as docA.xml, that is images/icon.png (probably not a valid reference).

Copy to

Copy the resource to the location of the saved document. The saved document references its own copy of the resource.

Example: if document /docs/docA.xml having resource images/icon.png is to be saved as /newdocs/docB.xml. The dialog box will suggest to copy icon.png to /newdocs/images/icon.png in order to be able to reference its own copy as images/icon.png. Note that the /newdocs/images/ subdirectory will be created on the fly if needed to.

Reference as

Do not copy the resource to the location of the saved document. The saved document references the original resource.

Example: if document /docs/docA.xml having resource images/icon.png is to be saved as /newdocs/docB.xml. The dialog box will suggest to reference icon.png as ../docs/images/icon.png.