paweld/fpc
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/fpc/source.git synced 2025-04-20 16:09:31 +02:00
Code Issues Packages Projects Releases Wiki Activity

* Up to date for release

Browse Source
This commit is contained in:
michael 1999-06-08 14:13:30 +00:00
parent 72e22249c9
commit f3f30ed496
1 changed files with 108 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

145
docs/messages.tex
View File

@ -1,4 +1,3 @@
\section{General compiler messages}
This section gives the compiler messages which are not fatal, but which
display useful information. The number of such messages can be
@ -7,7 +6,7 @@
\item [Compiler: arg1]
When the \var{-vt} switch is used, this line tells you what compiler
is used.
\item [Source OS: arg1]
\item [Compiler OS: arg1]
When the \var{-vd} switch is used, this line tells you what the source
operating system is.
\item [Info: Target OS: arg1]
@ -18,8 +17,7 @@
looks for it's binaries.
\item [Using unit path: arg1]
When the \var{-vt} switch is used, this line tells you where the compiler
looks for compiled units. You can set this path with the \var{-Fu} or
\var{-Up} options.
looks for compiled units. You can set this path with the \var{-Fu}
\item [Using include path: arg1]
When the \var{-vt} switch is used, this line tells you where the compiler
looks for it's include files (files used in \var{\{\$I xxx\}} statements).
@ -67,7 +65,7 @@
multiple lines.
\item [Fatal: illegal character]
An illegal character was encountered in the input file.
\item [Fatal: Syntax error arg1 expected but arg2 found]
\item [Fatal: Syntax error, arg1 expected but arg2 found]
This indicates that the compiler expected a different token than
the one you typed. It can occur almost everywhere where you make a
mistake against the pascal language.
@ -81,7 +79,7 @@
\item [Note: argF directive (FAR) ignored]
The \var{FAR} directive is a 16-bit construction which is recorgnised
but ignored by the compiler, since it produces 32 bit code.
\item [Note: Stack check is global under linux]
\item [Note: Stack check is global under Linux]
Stack checking with the \var{-Cs} switch is ignored under \linux, since
\linux does this for you. Only displayed when \var{-vn} is used.
\item [Note: Ignored compiler switch arg1]
@ -186,13 +184,13 @@
reading an include file.
\item [Warning: Unsupported application type: arg1]
You get this warning, ff you specify an unknown application type
with the directive \{\$APPTYPE\}
with the directive \var{\{\$APPTYPE\}}
\item [Warning: argAPPTYPE isn't support by the target OS]
The \{\$APPTYPE\} directive is supported by win32 applications only
The \var{\{\$APPTYPE\}} directive is supported by win32 applications only
\item [Warning: Unsupported assembler style specified arg1]
When you specify an assembler mode with the \var{\{\$ASMMODE xxx\}}
the compiler didn't recognize the mode you specified.
\item [Warning: ASM reader switch is not possible inside asm statement arg1 will be effective only for next]
\item [Warning: ASM reader switch is not possible inside asm statement, arg1 will be effective only for next]
It is not possible to switch from one assembler reader to another
inside an assmebler block. The new reader will be used for next
assembler statement only.
@ -222,12 +220,12 @@
This is introduced first for Delphi compatibility.
\item [Error: No DLL File specified]
No longer in use.
\item [Error: DLL exported function names cannot be double arg1]
\item [Error: Duplicate exported function name arg1]
Exported function names inside a specific DLL must all be different
\item [Error: DLL exported function indexes cannot be double arg1]
\item [Error: Duplicate exported function index arg1]
Exported function names inside a specific DLL must all be different
\item [Error: Invalid index for DLL exported function]
DLL function index must be in the range 1..\$FFFF
\item [Error: Invalid index for exported function]
DLL function index must be in the range \var{1..\$FFFF}
\item [Error: Constructor name must be INIT]
You are declaring a constructor with a name which isn't \var{init}, and the
\var{-Ss} switch is in effect. See the \var{-Ss} switch (\seeo{Ss}).
@ -267,7 +265,7 @@
\item [Error: Illegal parameter list]
You are calling a function with parameters that are of a different type than
the declared parameters of the function.
\item [Error: Wrong parameter type specified for arg NN]
\item [Error: Wrong parameter type specified for arg 1]
There is an error in the parameter list of the function or procedure.
The compiler cannot determine the error more accurate than this.
\item [Error: Wrong amount of parameters specified]
@ -286,7 +284,7 @@
\item [Error: function header arg1 doesn't match forward : var name changes arg2 => arg3]
You declared the function in the \var{interface} part, or with the
\var{forward} directive, but define it with a different parameter list.
\item [Note: only values can be jumped over in enumeration types]
\item [Note: Values in enumeration types have to be ascending]
\fpc allows enumeration constructions as in C. Given the following
declaration two declarations:
\begin{verbatim}
@ -295,7 +293,7 @@
\end{verbatim}
The second declaration would produce an error. \var{A\_UAS} needs to have a
value higher than \var{A\_E}, i.e. at least 7.
\item [Note: Interface and implementation names are different !]
\item [Note: Interface and implementation names are different arg1 => arg2]
This note warns you if the implementation and interface names of a
functions are different, but they have the same mangled name. This
is important when using overloaded functions (but should produce no error).
@ -322,12 +320,17 @@
The length of a string in Pascal is limited to 255 characters. You are
trying to declare a string with length lower than 1 or greater than 255
(This is not true for \var{Longstrings} and \var{AnsiStrings}.
\item [Warning: use extended syntax of DISPOSE and NEW to generate instances of objects]
\item [Warning: use extended syntax of NEW and DISPOSE for instances of objects]
If you have a pointer \var{a} to a class type, then the statement
\var{new(a)} will not initialize the class (i.e. the constructor isn't
called), although space will be allocated. you should issue the
\var{new(a,init)} statement. This will allocate space, and call the
constructor of the class.
\item [Warning: use of NEW or DISPOSE for untyped pointers is meaningless]
\item [Error: use of NEW or DISPOSE is not possible for untyped pointers]
You cannot use \var{new(p)} or \var{dispose(p)} if \var{p} is an untyped pointer
because no size is associated to an untyped pointer.
Accepted for compatibility in \var{tp} and \var{delphi} modes.
\item [Error: class identifier expected]
This happens when the compiler scans a procedure declaration that contains
a dot,
@ -385,7 +388,7 @@
\item [Error: The symbol can't be exported from a library]
You can only export procedures and functions when you write a library. You
cannot export variables or constants.
\item [Warning: A inherited method is hidden by arg1]
\item [Warning: An inherited method is hidden by arg1]
A method that is declared \var{virtual} in a parent class, should be
overridden in the descendent class with the \var{override} directive. If you
don't specify the \var{override} directive, you will hide the parent method;
@ -467,7 +470,7 @@
A \var{with} statement needs an argument that is of the type \var{record}
or \var{class}. You are using \var{with} on an expression that is not of
this type.
\item [Error: Functions with void return value can't return any value]
\item [Error: Procedures can't return a value]
In \fpc, you can specify a return value for a function when using
the \var{exit} statement. This error occurs when you try to do this with a
procedure. Procedures cannot return a value.
@ -485,7 +488,7 @@
\var{new}. The constructor must be used for that. For the same reason, you
cannot call \var{Dispose} to de-allocate an instance of a class, the
destructor must be used for that.
\item [Error: Assembler incompatible with function return value]
\item [Error: Assembler incompatible with function return type]
You're trying to implement a \var{assembler} function, but the return type
of the function doesn't allow that.
\item [Error: Procedure overloading is switched off]
@ -537,7 +540,10 @@
var p : longint absolute x;
\end{verbatim}
\item [Error: Abtract methods shouldn't have any definition (with function body)]
\item [Error: Only ONE variable can be initialized]
You cannot specify more than one variable with a initial value
in Delphi syntax.
\item [Error: Abstract methods shouldn't have any definition (with function body)]
Abstract methods can only be declared, you cannot implement them. They
should be overridden by a descendant class.
\item [Error: This overloaded function can't be local (must be exported)]
@ -672,6 +678,26 @@
Parameters are declared as call by reference using the \var{var}-directive
\item [Error: Duplicate message label: arg1]
A label for a message is used twice in one object/class
\item [Error: Self can be only an explicit parameter in message handlers]
The self parameter can be passed only explicit if it is a method which
is declared as message method handler
\item [Error: Threadvars can be only static or global]
Threadvars must be static or global, you can't declare a thread
local to a procedure. Local variables are always local to a thread,
because every thread has it's own stack and local variables
are stored on the stack
\item [Fatal: Direct assembler not supported for binary output format]
You can't use direct assembler when using a binary writer, choose an
other outputformat or use an other assembler reader
\item [Warning: Don't load OBJPAS unit manual, use \var{\{\$mode objfpc\}} or
\\var{\{\$mode delphi\}} instead]
You're trying to load the ObjPas unit manual from a uses clause. This is
not a good idea to do, you can better use the \var{\{\$mode objfpc\}} or
\var{\{\$mode delphi\}}
directives which load the unit automaticly
\item [Error: OVERRIDE can't be used in objects]
Override isn't support for objects, use VIRTUAL instead to override
a method of an anchestor object
\end{description}
\section{Type checking errors}
This section lists all errors that can occur when type checking is
@ -685,6 +711,21 @@
\item You are calling a function or procedure with parameters that are
incompatible with the parameters in the function or procedure definition.
\end{itemize}
\item [Error: Incompatible types: got "arg1" expected "arg2"]
There is no conversion possible between the two types
Another possiblity is that they are declared in different
declarations:
\begin{verbatim}
Var
A1 : Array[1..10] Of Integer;
A2 : Array[1..10] Of Integer;
Begin
A1:=A2; { This statement gives also this error, it
is due the strict type checking of pascal }
End.
\item [Error: Type mismatch between arg1 and arg2]
The types are not equal
\item [Error: Integer expression expected]
The compiler expects an expression of type integer, but gets a different
type.
@ -696,7 +737,7 @@
The identifier is not a type, or you forgot to supply a type identifier.
\item [Error: Variable identifier expected]
This happens when you pass a constant to a \var{Inc} var or \var{Dec}
proceure. You can only pass variables as arguments to these functions.
procedure. You can only pass variables as arguments to these functions.
\item [Error: pointer type expected]
The variable or expression isn't of the type \var{pointer}. This
happens when you pass a variable that isn't a pointer to \var{New}
@ -754,6 +795,13 @@
\item [Error: Integer or real expression expected]
The first argument to \var{str} must a real or integer type.
\item [Error: Wrong type in array constructor]
You are trying to use a type in an array constructor which is not
allowed.
\item [Error: Incompatible type for arg arg1: Got arg2, expected arg3]
You are trying to pass an invalid type for the specified parameter.
\item [Error: Method (variable) and Procedure (variable) are not compatible]
You can't assign a method to a procedure variable or a procedure to a
method pointer.
\end{description}
\section{Symbol handling}
This section lists all the messages that concern the handling of symbols.
@ -769,6 +817,8 @@
the circumstances in which the error occurs.
\item [Error: Duplicate identifier arg1]
The identifier was already declared in the current scope.
\item [Hint: Identifier already defined in arg1 at line arg2]
The identifier was already declared in a previous scope.
\item [Error: Unknown identifier arg1]
The identifier encountered hasn't been declared, or is used outside the
scope where it's defined.
@ -798,13 +848,13 @@
the circumstances in which the error occurs.
\item [Fatal: record or class type expected]
The variable or expression isn't of the type \var{record} or \var{class}.
\item [Error: Instances of classes or objects with an abtsract method are not allowed]
\item [Error: Instances of classes or objects with an abstract method are not allowed]
You are trying to generate an instance of a class which has an abstract
method that wasn't overridden.
\item [Warning: Label not defined arg1]
A label was declared, but not defined.
\item [Error: Illegal label declaration]
\item [Error: GOTO und LABEL are not supported (use command line switch -Sg)]
\item [Error: GOTO und LABEL are not supported (use switch -Sg)]
You must compile a program which has \var{label}s and \var{goto} statements
with the \var{-Sg} switch. By default, \var{label} and \var{goto} aren't
supported.
@ -834,9 +884,10 @@
\item [Error: Unknown record field identifier arg1]
The field doesn't exist in the record definition.
\item [Warning: Local variable arg1 does not seem to be initialized]
This message is displayed if the compiler thinks that a variable will
\item [Warning: Variable arg1 does not seem to be initialized]
These messages are displayed if the compiler thinks that a variable will
be used (i.e. appears in the right-hand-side of an expression) when it
wasn't initialized first (i.e. appeared in the right-hand side of an
wasn't initialized first (i.e. appeared in the left-hand side of an
assigment)
\item [Error: identifier idents no member arg1]
When using the extended syntax of \var{new}, you must specify the constructor
@ -861,8 +912,8 @@
\item [Error: Illegal expression]
This can occur under many circumstances. Mostly when trying to evaluate
constant expressions.
\item [Error: Invalid integer]
You made an exression which isn't an integer, and the compiler expects the
\item [Error: Invalid integer expression]
You made an expression which isn't an integer, and the compiler expects the
result to be an integer.
\item [Error: Illegal qualifier]
One of the following is happening :
@ -888,6 +939,9 @@
\item [Error: Illegal type conversion]
When doing a type-cast, you must take care that the sizes of the variable and
the destination type are the same.
\item [Conversion between ordinals and pointers is not portable across platforms]
If you typecast a pointer to a longint, this code will not compile
on a machine using 64bit for pointer storage.
\item [Error: File types must be var parameters]
You cannot specify files as value parameters, i.e. they must always be
declared \var{var} parameters.
@ -920,7 +974,7 @@
end;
\end{verbatim}
\item [Error: procedure call with stackframe ESP/SP]
The compiler enocountered a procedure or function call inside a
The compiler encountered a procedure or function call inside a
procedure that uses a \var{ESP/SP} stackframe. Normally, when a call is
done the procedure needs a \var{EBP} stackframe.
\item [Error: Abstract methods can't be called directly]
@ -951,23 +1005,32 @@
Your code requires a too big stack. Some operating systems pose limits
on the stack size. You should use less variables or try ro put large
variables on the heap.
\item [Stack frame is omited]
\item [Stack frame is omitted]
Some procedure/functions do not need a complete stack-frame, so it is omitted.
This message will be displayed when the {-vd} switch is used.
\item [Error: Unable to inline object methods]
\item [Error: Object or class methods can't be inline.]
You cannot have inlined object methods.
\item [Error: Unable to inline procvar calls]
\item [Error: Procvar calls can't be inline.]
A procedure with a procedural variable call cannot be inlined.
\item [Error: No code for inline procedure stored]
The compiler couldn't store code for the inline procedure.
\item [Error: Element zero of an ansi/wide- or longstring can't be accessed, use (set)length instead]
You should use \var{setlength} to set the length of an ansi/wide/longstring
and \var{length} to get the length of such kinf of string
\item [Error: Include or exclude not implemented in this case]
\item [Error: Include and exclude not implemented in this case]
\var{include} and \var{exclude} are only partially
implemented for \var{i386} processors
and not at all for \var{m68k} processors.
\item [Constructors or destructors can not be called inside with here]
\item [Warning: Probably illegal constant passed to internal math function]
The constant argument passed to a ln or sqrt function is out of
the definition range of these functions, you may get unexpected
results when running the program
\item [Error: Constructors or destructors can not be called inside a 'with' clause]
Inside a \var{With} clause you cannot call a constructor or destructor for the
object you have in the \var{with} clause.
\item [Error: Cannot call message handler method directly]
A message method handler method can't be called directly if it contains an
explicit self argument
\end{description}
\section{Unit loading messages.}
This section lists all messages that can occur when the compiler is
@ -1069,7 +1132,7 @@
\item [PPU Check file arg1 time arg2]
When you use the \var{-vu} flag, the compiler show the filename and
date and time of the file which a recompile depends on
\end{description}
\end{description}
\section{Command-line handling errors}
This section lists errors that occur when the compiler is processing the
@ -1118,8 +1181,16 @@
It is possible to have a compiler executable that doesn't support
the generation of debugging info. If you use such an executable with the
\var{-g} switch, this warning will be displayed.
\item [Warning: You are using the obsolete switch arg1]
\item [Error: You are using the obsolete switch arg1]
this warns you when you use a switch that is not needed/supported anymore.
It is recommended that you remove the switch to overcome problems in the
future, when the switch meaning may change.
\end{description}
\item [Error: You are using the obsolete switch arg1, please use arg2]
this warns you when you use a switch that is not supported anymore. You
must now use the second switch instead.
It is recommended that you change the switch to overcome problems in the
future, when the switch meaning may change.
\item [Note: Switching assembler to default source writing assembler]
this notifies you that the assembler has been changed because you used the
-a switch which can't be used with a binary assembler writer.
\end{description}