Skip to content

File Name Form

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 AppSrc folder of the selected workspace.

If you selected [Defaults], you will be expected to enter the name of a source-code file from the working folder. The prompt button will allow you to browse files starting with the working folder. 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 starts the compilation process, as does clicking the Compile button.

Here is how the compiler determines what information to use:

  • [Defaults]
    (noWorkspace)

  • Workspace

  • Source-code file

  • Source
    If it includes a path, AppSrcPath/Source, otherwise.

  • Output (exe) filename

  • SrcRoot
    (root name of Source)
    If it includes a path, ProgramPath/SrcRoot, otherwise.

  • Output folder
    Same as Source

  • AppSrcPath

  • Used/included files
    MakePath in [DFCOMP]
    AppSrcPath;ProgramPath; …

  • Data and data-dictionary files
    Folder started in.
    DataPath

  • Compile options
    BuildOptions in [DFCOMP]
    BuildOptions in [Workspace], then in [DFCOMP]

Source refers to the source pathname/file passed from the command line or selected. SrcRoot is source without its extension.

Except in the case of use and #include files, only the first folder 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 folder path. The presence or absence of a folder 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 folder. 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 folder 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 folder. 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 folder listed in MakePath.

See Also

The Compiler Interface