|
|
@@ -1075,6 +1075,8 @@ integer errors, a run-time error will be generated by your program.
|
|
|
\item [-Cr] \olabel{Cr} Generate Range checking code. In case your program
|
|
|
acesses an array element with an invalid index, or if it increases an
|
|
|
enumerated type beyond it's scope, a run-time error will be generated.
|
|
|
+\item [-CR] \olabel{CR} Generate checks when calling methods to verify
|
|
|
+if the virtual method table for that object is valid.
|
|
|
\item [-Csxxx] \olabel{Cs} Set stack size to \var{xxx}.
|
|
|
\item [-Ct] \olabel{Ct} generate stack checking code. In case your program
|
|
|
performs a faulty stack operation, a run-rime error will be generated.
|
|
|
@@ -1090,7 +1092,9 @@ to conditionally compile parts of your code.
|
|
|
\item [-gg] idem as \var{-g}.
|
|
|
\item [-gd] \olabel{gd} generate debugging info for \file{dbx}.
|
|
|
\item [-gh] use the heaptrc unit (see \unitsref).
|
|
|
-\item [-gc] generate checks for pointers.
|
|
|
+\item [-gc] generate checks for pointers. This must be used with the
|
|
|
+\var{-gh} command-line option. When this options is enabled, it will verify
|
|
|
+that all pointer accesses are within the heap.
|
|
|
\item[-kxxx] pass \var{xxx} to the linker.
|
|
|
\item[-Oxxx] \olabel{O} optimize the compiler's output; \var{xxx} can have one
|
|
|
of the following values :
|
|
|
@@ -1136,12 +1140,12 @@ the following:
|
|
|
of the \var{-d} option.
|
|
|
\item [-Ur] \olabel{Ur} Generate release unit files. These files will not be
|
|
|
recompiled, even when the sources are available. This is useful when making
|
|
|
-release distributions.
|
|
|
+release distributions. This also overrides the \var{-B} option for release
|
|
|
+mode units.
|
|
|
\item [-Xx] \olabel{X} executable options. This tells the compiler what
|
|
|
kind of executable should be generated. the parameter \var{x}
|
|
|
can be one of the following:
|
|
|
\begin{itemize}
|
|
|
-% \item \textbf{e} : (\linux only) Create an \file{ELF} executable (default).
|
|
|
\item \textbf{c} : (\linux only) Link with the C library. You should only use this when
|
|
|
you start to port \fpc to another operating system. \olabel{Xe}
|
|
|
\item \textbf{D} : Link with dynamic libraries (defines the
|
|
|
@@ -3397,8 +3401,10 @@ The stack has grown beyond its maximum size (in which case the size of
|
|
|
local variables should be reduced to avoid this error), or the stack has
|
|
|
become corrupt. This error is only reported when stack checking is enabled.
|
|
|
\item [203 Heap overflow error]
|
|
|
-The heap has grown beyond its boundaries, and you are trying to get more
|
|
|
-memory. Please note that \fpc provides a growing heap, i.e. the heap will
|
|
|
+The heap has grown beyond its boundaries. This is caused when trying to allocate
|
|
|
+memory exlicitly with \var{new}, \var{getmem} or \var{reallocmem}, or when
|
|
|
+a class or object instance is created and no memory is left. Please note
|
|
|
+that, by default, \fpc provides a growing heap, i.e. the heap will
|
|
|
try to allocate more memory if needed. However, if the heap has reached the
|
|
|
maximum size allowed by the operating system or hardware, then you will get
|
|
|
this error.
|
carl