May 27, 2010 RESOLVELINKS Darwin

resolveLinksResolves link requests in collections of HTML files aTreat external (seeded) paths as absolute. If passed after a s argument, modifies that argument. If passed before any s arguments, modifies all seed files. This may be specified multiple times. b basepathBase path. Paths in x output file are generated relative to this path. If this ends with a trailing /, resolveLinks assumes that the contents of the specified directory will be installed in the location specified by the i flag. Otherwise, it is assumed that the directory itself will be installed there. (The cp command behaves similarly.) If unspecified, defaults to /. d debugflagsSets debug flags (bitmask). DDisables dot printing (for cleaner debugging). hPrints a usage summary. i installpathLocation where this directory will eventually be installed. Used for generating relative paths for external (seeded) paths. If unspecified, the value of the b flag is used. nDisables all file writes (except for the seed output file). NDisables name-based matching (normally used for unknown symbol names in user-entered link requests). Disabling this matching can provide a performance gain for large doc trees. PDisables partial matching. Disabling this matching can provide a performance gain for large doc trees. r refanchorprefixAdditional reference anchor prefix. The default, "apple_ref", is always active; if you use something else, add a r option. This may be specified multiple times. s seedfileA seed file generated by the x option from a previous run of the tool. Used to add additional external cross references from other folders. This may be passed multiple times. S seedfilebasepathA base path prepended to the immediate previous seed file for path purposes. This may be passed multiple times (once per seed file). t nthreadsThe number of threads to use during resolution. Default is 2. x xreffileAn output cross-reference file. You can pass this file to future runs of the tool by using the s flag. directorythe directory to be processed.

This program is a helper tool that is usually run by the gatherHeaderDoc tool to generate links within HeaderDoc output. Although it is usually not run directly, it can be useful to do so when linking together multiple documentation sets in an installed set.

For more information on gatherHeaderDoc and HeaderDoc, see headerdoc2html

and gatherheaderdoc