dirlist
A space-separated list of
directories in which to search for the hypertext documents to be linked (as identified by their
“.htx” file extension). If this list is not given, the default directory “.” is used.
-a
Specifies that all documents in the specified directories should be re-linked “from
source”. This means that all documents will be re-examined for cross-references, regardless of
whether they appear to have changed since they were last linked, and all the resulting
cross-references will be resolved.
-d
Specifies that a “deep” dependency test should be
performed to see which documents have changed, and therefore need re-linking. This
involves examining the modification dates of all the “.html” files in each document. A deep
dependency test is more likely to identify changed documents than the default method (which
simply examines the modification date of the
document directory file) but it may take
considerably longer.
-r
Specifies that documents that make references only to other
“remote”
documents should be re-linked. This option is present for historical reasons and it should not
normally be necessary to use it. It may eventually be removed.
-v
Specifies “verbose
mode”, which results in additional information about the linking process being written to
standard output.
Documents which are found on the
HTX_PATH search path will be
linked against (
i.e. references to them will be resolved), but they will not themselves be
modified unless they are also found in the directory list specified on the command line.