Key or File: Edit Box
File Name
The File Name form is provided for you to instruct the compiler which source-code file to compile. If you selected a workspace, you will be expected to enter the name of a source-code file that is associated with that workspace. The prompt button (…) to the right of the edit box will allow you to browse files starting with the AppSrcPath directory of the selected workspace.
If you selected [Defaults], you will be expected to enter the name of a source-code file from the working directory. The prompt button will allow you to browse files starting with the working directory. Of course, you may enter a full path in the case of a workspace or [Defaults] and in that way, compile any file.
Pressing Enter in this box launches the compilation, as does pressing the Compile button.
Here is how the compiler determines what information to use:
| [Defaults] | (no Workspace) | |
| Workspace | ||
| Source-code file | Source if it includes a path, AppSrcPath/Source, otherwise. |
|
| Output (exe) filename | SrcRoot (root name of Source) |
Source if it includes a path, ProgramPath/SrcRoot, otherwise. |
| Output directory | Same as Source | |
| Used/included files | MakePath in [DFCOMP] | AppSrcPath; ProgramPath;… |
| Data and data-dictionary files | Directory started in. | DataPath |
| Compile options | BuildOptions in [DFCOMP] | BuildOptions in [Workspace], then in [DFCOMP] |
Source refers to the source file/pathname passed from the command line or selected. SrcRoot is the source without its extension.
Except in the case of used/included files, only the first directory listed in AppSrcPath, ProgramPath, and DataPath is used.
File
In compilation, if workspace or key is used, the workspace will be used for finding package files, data dictionaries, compiler options, and anything else required by the compilation.
The filename may be entered with or without a directory path. The presence or absence of a directory path affects where files are found and written, as follows:
With Path
The compiler will look for the source-code file only in the entered directory. If OutputDirectory is set in the program area or the DFComp key, it will be used to place the output files. Otherwise, the output files will be placed in the directory in which the source-code file was found.
Without Path
The compiler will search for the source-code file in the directories listed in MakePath. If OutputDirectory is set in the DFComp key or the program area, the output files will be written to that directory. Otherwise, the compiler will overwrite the first existing compiled program file with the name matching that of the file the compiler will write found in the directories listed in MakePath. If no such file is found, the new file will be placed in the first directory listed in MakePath.