compile(3)

NAME

compile - Start a compilation process recompile - Rerun compilation process

SYNOPSIS

n compile ["auto-touch-file"] "compile-command"
recompile

DESCRIPTION

compile gets and executes the compile command using a pipe execution (incremental pipe on UNIX platforms), loading the output into a buffer called "*compile*", with go to error parsing using the command get-next-line(2). The default compile execution is set by variable %compile-com(5), the error parsing is setup using the command add-next-line(2).

Before the compile command is executed save-some-buffers(2) is executed to allow the user to ensure that all relevant buffers are saved.

Compile uses command ipipe-shell-command(2) to launch the given system compile-command. By default the output lines in the window are wrapped at 2046 characters as a balance between reliably searching for errors and usability. See flag 0x02 below or help on ipipe-shell-command(2) for details on how to change this behaviour.

The argument n can be used to change the default behavior of compile described above, n is a bit based flag where:-

0x01


Enables the user prompt before saving buffers, if this flag is not supplied then all modified visible buffers will be written.

0x02


When set the compile output lines will be wrapped at the width of the current window.

0x04


When set the previous compile-command is automatically used for this compile.

0x08


When set the previous compile location (path) is automatically used for this compile.

0x10


When set the compile prompts for an auto-touch-file, when set to a file name this file is automatically touched (modification timestamp updated without changing the files content) on this and any subsequent compiles. The feature is disabled if set to an empty string.

recompile reruns the previous compile process, it is implemented by executing compile with flags 0x04 and 0x08, the other flags of compile can also be passed to this command.

NOTES

compile and recompile are macros defined in tools.emf.

SEE ALSO

add-next-line(2), %compile-com(5), get-next-line(2), save-some-buffers(2), grep(3).

(c) Copyright JASSPA 2025
Last Modified: 2022/06/12
Generated On: 2025/09/29