Streamlining the [FILES] Section with #include

Every project file has a [FILES] section that lists all topic files used to produce a Viewer title. The following sample shows the format of the [FILES] section for the USA Tour sample title:

[FILES]
.\natext\states_a.rtf ;Arizona
.\natext\states_c.rtf ;California
.\natext\states_h.rtf ;Hawaii
.\natext\states_k.rtf ;Kentucky
.\natext\states_m.rtf ;Massachusetts
.\natext\states_n.rtf ;New York, North Dakota
.\natext\states_t.rtf ;Texas
.\natext\states_v.rtf ;Virginia
.\natext\states_w.rtf ;Washington
.
.
.

This section can become very large if you have many topic files in your title. Instead of naming these files directly under the [FILES] section, you can create an include file that lists the files used for the title build. Using the #include command, you could then list the name of the include file under [FILES]. The contents of the include file are treated as if they appeared in the .MVP file. You can list multiple include files in this section.

You must always name include files with a .H extension. The contents of a typical include file named USA.H might look like this:

.\natext\states_a.rtf ;Arizona
.\natext\states_c.rtf ;California
.\natext\states_h.rtf ;Hawaii
.\natext\states_k.rtf ;Kentucky
.\natext\states_m.rtf ;Massachusetts
.\natext\states_n.rtf ;New York, North Dakota
.\natext\states_t.rtf ;Texas
.\natext\states_v.rtf ;Virginia
.\natext\states_w.rtf ;Washington

Under the [FILES] section of the project file, use the #include command to list the include files used during the build process. The #include command has the following syntax:

#include <filename>

The filename identifies the include file. You must include the angle brackets around the filename. The filename must specify a complete path, either a path relative to the ROOT option or an absolute directory path to the include file.

The number sign (#) must be the first character of the line with #include. The following example shows how you might use #include:

[FILES]
#include <usa.h>