ERRORFILE: Filename specification error

Tools

Compiler, Assembler, or Linker

Syntax

ERRORFILE=<filename>

Arguments

<filename>: Filename with possible format specifiers

Default

EDOUT

Description

The ERRORFILE environment variable specifies the name for the error file (used by the Compiler or Assembler).

Possible format specifiers are:

'%n': Substitute with the filename, without the path.
'%p': Substitute with the path of the source file.
'%f': Substitute with the full filename, i.e., with the path and name (the same as '%p%n').

In case of an improper error filename, a notification box is shown.

Examples

The following listing lists all errors into the MyErrors.err file in the current directory.

Listing: Naming an error file


ERRORFILE=MyErrors.err

The following listing lists all errors into the errors file in the \tmp directory.

Listing: Naming an error file in a specific directory


ERRORFILE=\tmp\errors

The following listing lists all errors into a file with the same name as the source file, but with extension *.err, into the same directory as the source file, e.g., if we compile a file \sources\test.c, an error list file \sources\test.err will be generated.

Listing: Naming an error file as source filename



ERRORFILE=%f.err

For a test.c source file, a \dir1\test.err error list file will be generated, as the following listed shows:

Listing: Naming an error file as source filename in a specific directory



ERRORFILE=\dir1\%n.err

For a \dir1\dir2\test.c source file, a \dir1\dir2\errors.txt error list file will be generated, as the following listed shows:

Listing: Naming an error file as a source filename with full path


ERRORFILE=%p\errors.txt

If the ERRORFILE environment variable is not set, errors are written to the default error file. The default error filename depends on the way the Assembler is started.

If a filename is provided on the assembler command line, the errors are written to the EDOUT file in the project directory.

If no filename is provided on the assembler command line, the errors are written to the err.txt file in the project directory.

The following listed shows another example for the usage of this variable to support correct error feedback with the WinEdit Editor which looks for an error file called EDOUT:

Listing: Configuring error feedback with WinEdit


Installation directory: E:\INSTALL\prog
Project sources: D:\SRC

Common Sources for projects: E:\CLIB

Entry in default.env (D:\SRC\default.env):

ERRORFILE=E:\INSTALL\prog\EDOUT

Entry in WinEdit.ini (in Windows directory):

OUTPUT=E:\INSTALL\prog\EDOUT

Note: You must set this variable if the WinEdit Editor is used, otherwise the editor cannot find the EDOUT file.