This function appends the directory dir to the set catalogpath option if 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 document types stored in the doctypes subdirectory of the company directory, so your document types are searched last:

If you wanted to prepend your document types stored in that same doctypes subdirectory, so your document types are searched first:

If there is a catalog file in the Arbortext-path\custom\doctypes subdirectory at startup, the \custom\doctypes path is automatically prepended to the catalog path. If there are any subdirectories of the \doctypes directory that contain a catalog file, those subdirectories are also prepended to the catalog path. Putting a catalog file in \custom\doctypes or in subdirectories of it makes them automatically available, avoiding additional steps to add them to the path.