Project Properties Dialog Box (Visual LISP IDE)

Manages the AutoLISP source files and build options for a project.

Note: The Visual LISP IDE is available on Windows only.

Summary

In Visual LISP, click Project Project Properties.

List of Options

Project Files tab

Specifies which files to add to or are in a project.

Home Directory

Lists the project’s folder, and the one to use when looking for and compiling AutoLISP source files.

Look In

Specifies the folder that the Project Properties dialog box should look in for AutoLISP source files.

AutoLISP Source Files

Lists the AutoLISP source files that are found in the folder specified in the Look In box.

>

Adds the files selected in the AutoLISP Source Files list to the project.

<

Removes the files selected in the Project Files list from the project.

Project Files

Lists the AutoLISP source files that have been added to the project. The order of the files controls the order in which the files are loaded when compiling multiple AutoLISP source files into a single FAS file.

Note: Select and right-click a file to display its path and size. If a file is in the Home directory, the path of the file is not displayed.

Top

Moves the selected file to the top of the Project Files list.

Up

Moves the selected file up one place in the Project Files list.

Down

Moves the selected file down one place in the Project Files list.

Bottom

Moves the selected file to the bottom of the Project Files list.

(Un)Select All

Selects or deselects all the selected files in the AutoLISP Source Files and Project Files lists.

Messages

Displays status messages about the added files and settings being applied to the project.

Build Options tab

Specifies the settings to use when building a project.

Compilation Mode

Optimized compilation creates smaller and faster programs but is not suited for every project. Choose between standard and optimized compilation.

Localize Variables

Removes (drops) the names of all local symbols from compiled files and directly links their references, wherever possible. A program’s code is changed so it points to the address where a variable is stored, not to a symbol used to find the address of the variable.

Safe Optimize

Directs the compiler to refuse some types of optimization, if there is a chance they will result in incorrect code.

Merge Files Mode

Instructs the compiler to create a separate FAS file for each source file, or to merge all compiled files into a single FAS file.

A single FAS file is faster to load and is required for certain types of optimization. Sometimes, however, you will prefer to load your code one file at a time. This is important if you have not completed the debugging or modification of the application's code. FAS files do not allow source code debugging, so it is recommended that you compile your code only after the initial debugging is done.

Link Mode

Specifies how function calls are to be optimized. This option is only available if optimized compilation is selected. Choose from the following:

• Do not link: This results in indirect linking of functions. The compiler stores the address of the symbol naming the function.
• Link: If selected, the compiler directly addresses function definitions and all calls where the functions are referenced.
• Internal: This directly links function calls and removes (drops) the function names from the resulting FAS files.

FAS Directory

Specifies the directory for compiled files.

If you indicate a relative path, Visual LISP applies it in relation to the project's home directory. If you leave the field blank, Visual LISP places compiled files in the same directory as the project definition (.prj) file.

Tmp Directory

Specifies the directory for project-related temporary files.

A relative path is applied in relation to the project's home directory.

Message Mode

Select the level of detail you want Visual LISP to produce in its compilation reports. You can choose to receive a report showing only fatal errors (those causing compilation failure), a report showing errors and warning messages, or a full report showing errors, warnings, and compiler statistics.

Edit Global Declarations

Create or edit a global declarations file for the project.

This feature is provided for compatibility with the Preview version of Visual LISP.

Messages

Displays status messages about the added files and settings being applied to the project.