
How to Prepare the Target Documents for the External Link Tests
===============================================================

1 Introduction
--------------

The test documents for external targets contain various external links to test
the correct resolution of relative paths and network paths. A few preparations
are needed for these tests (see chapter 2 below). This ZIP archive contains
all needed external target documents and a command batch file that copies them
to the correct locations.

The archive "targets.zip" should contain:
- _README.TXT      This file.
- COPYDOC.BAT      The batch file to copy the target documents.
- EXTDATA2.XLS     Target document for link tests in BIFF2 format.
- EXTDATA3.XLS     Target document for link tests in BIFF3 format.
- EXTDATA4.XLS     Target document for link tests in BIFF4 format.
- EXTDATA4.XLW     Target document for link tests in BIFF4W format.
- EXTDATA5.XLS     Target document for link tests in BIFF5 format.
- EXTDATA8.XLS     Target document for link tests in BIFF8 format.
- EXTDATA12B.XLSB  Target document for link tests in BIFF12 format.
- EXTDATA12X.XLSX  Target document for link tests in MSOOXML format.
- EXTOBJ5.XLS      Target document for OLE object tests in BIFF5 format.
- EXTOBJ12.XLSX    Target document for OLE object tests in MSOOXML format.
- SMILEY.BMP       Target document for OLE object tests in BMP format.
- SMILEY.PNG       Target document for OLE object tests in PNG format.
- TEXT.TXT         Target document for OLE object tests in plain text format.

2 Preparing Paths and Documents
-------------------------------

Before copying the target documents, some root paths and system settings have
to be prepared manually. The descriptions apply to the Microsoft Windows
operating system.

2.1 Test Documents

The test documents themselves have to be located in a subdirectory on a DOS
drive that provides full read/write access to the user, e.g. in the directory
"E:\testdocs\", where the root directory "E:\" is fully accessible. The DOS
drive must not use the letter "X:" (this letter is needed below). The drive
can be a network drive that is mapped using the "Map Network Drive" feature or
the "net use" command of Windows, or a substituted drive that is created using
the "subst" command, e.g. to a particular directory in the user's "My
Documents" area.

2.2 The "targets.zip" Archive

All contents of this archive "targets.zip" have to be extracted/copied to the
same directory that contains the test documents, e.g. to the location
"E:\testdocs\" from the above example.

2.3 The X: Drive

A new drive "X:" has to be created. The drive can be a network drive or a
substituted drive (see above) that points to the same directory which contains
the test documents. Full read/write access has to be provided as well.

2.4 The Network Share "PATH"

A directory has to be shared in the network. The network share has to provide
read/write access to the user and needs to be named "PATH". Again, the same
directory that contains the test documents may be used. Note that Windows does
not allow to share directories from substituted drives, e.g. it is not
possible to share the directory "E:\testdocs\". In this case, the original
(unmapped) directory has to be used, e.g.
"C:\Documents And Settings\User\My Documents\testdocs\". If a client firewall
is installed, it has to allow access to IP address 127.0.0.1 (localhost).

2.5 Copying the Target Documents

Finally, the batch "COPYDOC.BAT" that copies the target documents can be
executed. It has to be started from the directory that contains the test
documents (see chapter 2.1), e.g. from "E:\testdocs\". First, the batch
creates the following paths:

- "PATH"      (paths relative to current location, e.g. "E:\testdocs\PATH\")
- "\PATH"     (paths on current DOS drive, e.g. "E:\PATH\")
- "X:\PATH"   (absolute paths on a DOS drive)

After that, the batch copies the target documents to the following paths:

- "PATH\"
- "\PATH\"
- "X:\PATH\"
- "\\127.0.0.1\PATH\"

The target documents are copied with different names to the individual paths
in order to allow that some of the paths may point to the same directory.

