ROOT Option

Syntax

ROOT=pathname[, pathname]...

The ROOT option specifies the project root directory where the Help compiler looks for the source files to include in the build.

Parameter

pathname

Specifies either a drive and full path or a relative path from the project directory. If you specify more than one project directory, a comma (,) separates each path. If the Help project file has a ROOT option, all relative paths in the Help project file refer to one of these paths. If the Help project file does not have a ROOT option, all paths are relative to the directory containing the Help project file.

Comments

If the Help project file does not have a BMROOT option, the compiler looks in the directories specified in the ROOT option to find bitmaps positioned by using the bmc, bml, and bmr references. If the Help project file doesn’t have a ROOT option or if none of the ROOT directories contain the bitmaps, the bitmap filenames must be listed in the [BITMAPS] section of the Help project file.

Example

The following entry specifies that the project root directory is C:\HELP\PROJECT and is found on drive C:

[OPTIONS]
ROOT=C:\HELP\PROJECT

Given this root directory, topic files can be listed relative to the project root directory in the [FILES] section:

[FILES]
.\RTF\TOPICS1.RTF
.\RTF\TOPICS2.RTF
.\RTF\TOPICS3.RTF
.\RTF\TOPICS4.RTF
.\RTF\TOPICS5.RTF

The full path for a topic file is C:\HELP\PROJECT\RTF\TOPICS1.RTF.

See Also

[BITMAPS] Section, BMROOT Option, [OPTIONS] Section