This pane is part of the Preferences window which is shown when you select the Preferences menu item.
This area controls the way in which gmake runs the commands specified in the Makefile to build targets.
in series: commands are run one at a time, one after the other.
in parallel, with a limit on the number of processes (commands) run at the same time. Equivalent to using the -j option to gmake.
in parallel, with a limit on the machine load (number of commands which can execute at any time). Equivalent to using the -l option to gmake.
If this checkbox is on, maketool will automatically open a text editor on the filename and line number mentioned in the first error message in a gmake run, as soon as the error message is added to the log window.
If this checkbox is on, maketool will skip warning messages and only select error messages when you use the Edit Next Error, Edit Prev Error, or Edit Next File Error menu items, or the Edit Next Error or Edit File Next Error tools.
If this checkbox is on, gmake will continue building targets after a target fails to be built. The normal behaviour of gmake is to stop when the first target fails. Equivalent to using the -k option to gmake.
If this checkbox is on, maketool will attempt to rebuild the Makefile in the working directory from a Makefile.am, Makefile.in or Imakefile file, every time a target is built. See Make Systems for more information.
If this checkbox is on, maketool will scroll to the end of the log window every time new text is added to the end of the log window.
This combobox allows you to specify an action which maketool will perform just before starting each gmake run.
Do nothing: maketool does not do anything special before each build.
Clear log: maketool clears all text from the log window before each build (as if you had used the Clear Log menu item).
Collapse all log items: maketool collapses all the indented text in the log window (as if you had used the Collapse All menu item).
This combobox allows you to specify an action which maketool will perform just after finishing each gmake run.
Do nothing: maketool does not do anything special after each build.
Beep: maketool emits a beep after each build.
Run command: maketool runs the command in the adjacent text field after each build, using all the maketool % Escape Characters and environment variable overrides. Maketool does not show the output of this command, wait for its completion, or take any notice of its exit code.
Typically, you would use this command to notify yourself that a build has finished.
Show dialog: maketool shows a dialog (shown below) after each build, which describes the target built and how many errors and warnings were found.
This is useful when your window manager provides multiple virtual desktops; you can start a build, change to another virtual desktop, and be notified when the build finishes. [1]
This combobox can be used to force gmake to use a different filename than the default for the Makefile (equivalent to the -f option). You can select one of the standard filenames in the menu, or type in any filename, or click the Browse button to choose a filename.
If you enter an absolute pathname (i.e. one that begins with the root directory, such as /usr/foo/bar/Makefile), that one Makefile will be used regardless of maketool's working directory. This is probably not what you want, as most Makefiles are not written to be used like that.
Normally you do not need to use the Makefile combobox, as gmake will figure out which Makefile to use by itself. Use the combobox only when you need to force gmake to use a non-standard filename for the Makefile. For example, when testing new Makefile features a name of Makefile.test would be useful.
[1] | You may need to configure your window manager to show dialogs on the current virtual desktop instead of with the parent application. |