This function appends the directory dir to the set ditapath option to search for content referenced by DITA documents, if the directory is not already present. If the optional argument prepend is specified and non-zero, dir is added to the beginning of the path list, removing any later occurrence of the directory. If prepend is zero or omitted and if dir is already present in the path list, the path list is returned.

For example, if you wanted to append your DITA references directory stored in the ditareferences subdirectory of the company directory, so your DITA references are searched last:

If you wanted to prepend your ditareferences subdirectory, so your DITA references are searched first:

If there is an Arbortext-path\custom\ditarefs subdirectory at startup, the custom\ditarefs path is automatically prepended to the DITA references path. Putting your DITA references in the custom\ditarefs subdirectory makes them automatically available, avoiding manual steps to add them to the path.

Graphic references in DITA files are resolved using the graphics path.