|Allegro CL version 10.0|
Moderately revised from 9.0.
The file menu displays commands mostly dealing with opening, closing and saving files or groups of files (a project is a group of files). The commands on the menu are:
The directory-choosing dialog first appears asking for a default
directory for the project's files. A project's files do not have to
be placed into this directory, but having a default directory allows
the IDE to default the file-selecting dialog to a directory that
typically is convenient. The immediate parent directory name will also
be the initial name of the project and its .lpr
project definition file; for example, if you specify the directory
c:/allegro-projects/first/, then the next File | Save
All that is done will save the project definition file as
project name could be changed later in the Project Manager dialog's
Options tab, and its
pathname could be changed by invoking File | Save As while the
Manager is the selected window.)
In addition, the first time a project is created there will be an earlier invocation of the directory dialog asking for a default parent directory for all new IDE projects. This default parent directory is used as the initially-selected parent directory whenever a new project asks for a default directory for that particular project. This dialog will not reappear as long as the allegro-ide-options.cl file is created and retained as usual, though the value could still be changed by setting the project-parent-directory configuration option.
The project system does not have to be used for an application, but is necessary for building form windows interactively, and for using the File | Build Project Executable and File | Build Project Distribution commands rather than writing a call to generate-application.
The contents of the Files of Type field of the dialog is controlled by the value of the IDE configuration option source-file-types. That option controls the type field for this File | Open command and for the dialog displayed by the File | Save As when saving an Editor file.
On GTK, to include dot files and other hidden files in the dialog's
list, you would need to specify
the file ~/.config/gtk-2.0/gtkfilechooser.ini. But you can always
type the name of a hidden file even if it's not shown in the list.
If the open-project-show-files-in-editor configuration option is true, then each of the project's source code files will be opened in the editor. The Project Manager will be shown if open-project-show-project-manager is true. The project's code will be compiled and loaded according to the current value of the open-project-action option.
There is also an Open Project item on the Recent menu. It displays a submenu of projects that have recently been opened, loaded, or saved, either in the current invocation of Lisp or a recent one. Selecting one of the projects opens it as the current project for editing.
When the editor is selected, the text in the selected editor buffer is saved. If a new buffer is being saved for the first time, the file dialog will first ask for a pathname for the file. If the editor buffer is for the .cl file that is associated with a form window, then the form's .bil file is also generated at this time (see maker-function).
If there is a current project, you will first be asked whether you would like to add the new file to the project. If you answer yes, then the file dialog will default to the current project's default directory, and the file will be added to the project after it is saved. If you answer no, then the file-selecting dialog will default as it otherwise would to the directory in which a file was last selected in the file dialog.
The Save command may also be used in certain other IDE windows. For example, when the focus is in a listener in the Debug Window, the text in the listener will be saved. In a form window, the form's .bil file is generated (see maker-function) and its associated .cl file in the editor (if any) is saved. In a stack backtrace, a bug report that contains the stack information will be written. In the Trace Dialog's outline widget, the trace information will be written as indented text. In the Inspector, the currently displayed table of values will be written. In the Project Manager dialog, the current project's .lpr project definition file will be written.
In some windows (the Class Browser, the Trace Dialog, the Runtime Analyzer Results dialog, the Inspector panes, and the backtrace pane in Debug window after an error) the text is actually written to a new editor buffer rather than to a file, to avoid the requirement to specify a pathname and create a file when you just want to view or copy the text. You can then use this same Save command in the editor buffer if you do want to save the text to a file.
You cannot use Save As when the Project Manager Dialog is the selected window. Save in that case saves the current project's .lpr project definition file, but that file should have the same filename as the project name, so it is inappropriate to use this command to modify the filename. Instead, change the name of the project (in the Options tab of the Project Manager) and say yes when asked if you want the .lpr name changed as well. To move the project files to a new directory, close the project, copy all the project files to the new directory using standard Operating System tools (such as the Windows Explorer) and then reopen the project from its new location.
If the name of the project (as specified on the Options tab of the Project Manager dialog) is my-application, for example, then the executable file will be named my-application on Linux or Mac, or my-application.exe on Windows. The dxl file will be named my-application.dxl.
build-lisp-image is used to build the new image.
See also build-project, which is a programmatic equivalent of this menu command.
The default distribution directory will be a subdirectory of the project's main directory named dist. The additional files will include a license file, plus any shared libraries that are internally known to be needed, along with any libraries and other arbitrary distributed files that you have specifically added to the project.
generate-application is called to do much of the work of this menu command.
See also build-project, which is a programmatic equivalent of this menu command. Note that on Macs and Linus machines, your user must have X11 and GTK installed. See Users of your app must have necessary software installed (such as X11 and GTK) in delivery.htm for more information.
Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 9.0 page.
|Allegro CL version 10.0|
Moderately revised from 9.0.