+---------------------------------+
|          BUILD PROJECT          |
+---------------------------------+
BUILD PROJECT <project file> FROM
        <program> | <menu> | <report>
        | <label> | <screen>
        | <library>
        [, <program> | <menu>
        | <report> | <label>
        | <screen>| <library>] ... ]

-----------------------------------
Creates project database.
-----------------------------------

BUILD PROJECT automatically creates a project database (.PJX) by opening
and processing one or more program, menu, report, label, screen and
library files that you specify.  The project keeps track of all the
files required to create an application, as well as the dependencies,
references and connections among the files.  Once you specify the pieces
in the project, FoxPro makes sure that the application is based on the
latest source files.  You can use the project file to create one of two
program types: an application or an executable (.EXE).

As FoxPro creates a project from the BUILD PROJECT command, all program
file references that include a path are processed using only the file
name portion.  The BUILD PROJECT command searches for the program first
in the default directory and, if not found there, along the FoxPro PATH.

For instance, suppose FoxPro encounters the line:

DO C:\FOXPRO\SOURCE\STARTUP.PRG

FoxPro looks for a program called STARTUP.PRG in the default directory.
If the program isn't in the default directory, FoxPro looks for
STARTUP.PRG along the FoxPro PATH.  If FoxPro can't find the file in
these locations, an error results.

When FoxPro encounters a program, menu or screen file while creating a
project file from BUILD PROJECT, it finds its compiled file, compares
its time-stamp to that of the matching .PRG file and, if necessary,
recompiles the source code.

Each project file contains a time-stamp so you can refresh it when you
make changes to files in the project or when dependencies change.  This
helps to guarantee that any applications created from a project file
will always use the most recent source.  To refresh a project file,
issue the BUILD PROJECT command without the optional FROM clause and
FoxPro updates the specified project.

When you issue a BUILD PROJECT command, unresolved references and other
errors are reported but do not prevent the project file from being
created.  This allows you to build a project, even though all the
necessary pieces are not actually created or available at the time the
project is built.  Unresolved references or other problems can then be
corrected by refreshing the project file at a later date or by manually
modifying the information stored in the project file with the MODIFY
PROJECT command.

Clauses
-------

<project file>
        Name of project database to be created.

FROM <program> | <menu> | <report>
        | <label> | <screen>| <library>
        [, <program> | <menu> | <report> | <label> | <screen> | <library>] ...
        Specifies files to include in project.

-----------------------------------

See Also:  BUILD APP, BUILD EXE, CREATE PROJECT, MODIFY PROJECT

-----------------------------------