Browse Source

* build messages.inc from errore.msg
* new zip and tar targets
* use fpcmake generated Makefile

peter 20 years ago
parent
commit
fc720b0fe2
4 changed files with 1976 additions and 1562 deletions
  1. 1391 48
      docs/Makefile
  2. 584 0
      docs/Makefile.fpc
  3. 0 1513
      docs/messages.tex
  4. 1 1
      docs/user.tex

File diff suppressed because it is too large
+ 1391 - 48
docs/Makefile


+ 584 - 0
docs/Makefile.fpc

@@ -0,0 +1,584 @@
+#
+#   $Id$
+#   This file is part of the Free Pascal run time library.
+#   Copyright (c) 1996-98 by Michael van Canneyt
+#
+#   Makefile for the Free Pascal Documentation
+#
+#   See the file COPYING.FPC, included in this distribution,
+#   for details about the copyright.
+#
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+#
+
+[package]
+name=fpdocs
+version=1.9.6
+
+[require]
+nortl=y
+
+[install]
+#fpcpackage=y
+
+[default]
+fpcdir=..
+rule=help
+
+[rules]
+# Debugging the install, that will only copy the .tex to index.html
+# so a make html and make install goes quickly
+#INSTALLDEBUG=1
+
+# Which docs to build by default
+ifndef DOCS
+DOCS = user rtl ref prog fpdoc chart
+endif
+
+# Can be 'report','book', 'html', 'hevea', 'ts3' 'ts4'
+ifdef USEHEVEA
+PREAMBLETYPE = hevea
+else
+ifdef USEL2H
+PREAMBLETYPE = html
+else
+PREAMBLETYPE = report
+endif
+endif
+
+# Locate FPDoc
+ifndef CROSSCOMPILE
+ifndef FPDOC
+ifneq ($(wildcard ../utils/fpdoc/fpdoc),)
+FPDOC=../utils/fpdoc/fpdoc
+else
+FPDOC=fpdoc
+endif
+endif
+endif
+
+ifndef FPCSRCDIR
+FPCSRCDIR=..
+endif
+
+# Use Ascii mode ? (i.e. no pics in produced HTML ?)
+ifndef ASCIIMODE
+ASCIIMODE=NO
+endif
+
+
+#######################################################################
+# LaTeX Program definitions
+#######################################################################
+
+# Latex itself
+ifndef LATEX
+LATEX = latex
+endif
+# DVI to PS converter
+ifndef DVIPS
+DVIPS=dvips
+endif
+# DVI to TXT converter
+ifndef DVITXT
+DVITXT=dvi2tty -w132
+endif
+# PDF converter
+ifndef PDFLATEX
+PDFLATEX=pdflatex
+endif
+# Makeindex programma
+ifndef MAKEINDEX
+MAKEINDEX=makeindex
+endif
+
+#######################################################################
+# Latex2html conversion.
+#######################################################################
+ifdef USEL2H
+# Command to use.
+ifndef LATEX2HTML
+LATEX2HTML = /usr/bin/latex2html
+endif
+# Default options for converter
+ifndef LATEX2HTMLOPTS
+LATEX2HTMLOPTS = -no_reuse -up_url "../fpctoc.html"\
+                 -up_title "Free Pascal manuals"\
+                 -html_version 4.0 -split 3
+endif
+ifeq ($(ASCIIMODE),YES)
+LATEX2HTMLOPTS+=-ascii_mode
+endif
+endif # USEL2H
+
+#######################################################################
+# HEVEA conversion.
+#######################################################################
+ifdef USEHEVEA
+# Hevea conversion.
+ifndef HEVEA
+HEVEA = /usr/bin/hevea
+endif
+ifeq ($(ASCIIMODE),YES)
+HEVEAOPTS+=-text
+endif
+endif # USEHEVEA
+
+# tmpdir
+export TMP=/tmp
+#
+
+
+PS = $(addsuffix .ps, $(DOCS))
+HTML = $(addsuffix .html, $(DOCS))
+DVI = $(addsuffix .dvi, $(DOCS))
+TXT = $(addsuffix .txt, $(DOCS))
+PDF = $(addsuffix .pdf, $(DOCS))
+TOC = $(addsuffix .toc, $(DOCS))
+AUX = $(addsuffix .aux, $(DOCS))
+LOG = $(addsuffix .log, $(DOCS))
+LOT = $(addsuffix .lot, $(DOCS))
+OUT = $(addsuffix .out, $(DOCS))
+
+
+#####################################################################
+# Conversion from types
+#####################################################################
+
+.PHONY: clean dvi help html ps psdist htmldist htmdist htdist pdfdist \
+        txtdist htm txt pdf refex alldist messages onechap gtk \
+        user ref prog rtl
+
+.SUFFIXES: .dvi .tex .ps .txt .pdf
+
+# default show help
+
+.dvi.ps:
+        $(DVIPS) $<
+
+.tex.dvi:
+        -rm $*.aux $*.idx  $*.ilg  $*.ind  $*.log  $*.out  $*.toc $*.tmp $*.xref $*.4ht
+        $(LATEX) $*
+        -$(MAKEINDEX) $*
+        $(LATEX) $*
+        -$(MAKEINDEX) $*
+        $(LATEX) $*
+
+.dvi.txt:
+        $(DVITXT) -o $*.txt  $*.dvi
+
+.tex.pdf:
+        -rm $*.aux $*.idx  $*.ilg  $*.ind  $*.log  $*.out  $*.toc $*.tmp $*.xref $*.4ht
+        $(PDFLATEX) $*
+        -$(MAKEINDEX) $*
+        $(PDFLATEX) $*
+        -$(MAKEINDEX) $*
+        $(PDFLATEX) $*
+
+$(TXT) : %.txt: %.dvi
+
+$(DVI) : %.dvi: %.tex
+
+$(PDF) : %.pdf: %.tex
+
+
+#####################################################################
+# Targets
+#####################################################################
+
+help:
+        @echo 'Possible targets :'
+        @echo ' dvi           : Make documentation using latex.'
+        @echo ' ps            : Make documentation using latex and dvips.'
+        @echo ' html          : Make HTML documentation using default converter.'
+        @echo ' hevea         : Make HTML documentation using hevea'
+        @echo ' l2h           : Make HTML documentation using latex2html'
+        @echo ' 4ht           : Make HTML documentation using tex4ht'
+        @echo ' pdf           : Make documentation using pdflatex'
+        @echo ' txt           : dvi, convert to text using dvi2tty'
+        @echo ' htm           : Convert .html to .htm files, zip result'
+        @echo ' clean         : Clean up the mess.'
+        @echo ' examples      : Comple all generic examples'
+        @echo ' linuxexamples : Compile all examples for linux'
+        @echo ' dosexamples   : Compile all examples for dos'
+        @echo ' execute       : Execute examples (DOS/Windows/OS/2 only)'
+        @echo ' htmldist      : html, and rchive result.'
+        @echo ' psdist        : ps, and archive result.'
+        @echo ' pdfdist       : pdf, and archive result.'
+
+clean:
+        -rm -f preamble.inc date.inc messages.inc
+        -rm -f *.4tc *.4ct *.css *.lg *.tmp *.xref
+        -rm -rf $(DOCS)
+        -rm -f $(TOC) $(LOG) $(DVI) $(PDF) $(AUX) $(OUT) $(PS) $(HTML) *.i* $(LOT) $(TXT)
+# Styles
+        -rm -f $(notdir $(wildcard styles/*))
+
+distclean: clean cleanexamples
+        -rm -f *.tar.gz *.zip
+
+#####################################################################
+# Include files
+#####################################################################
+
+date.inc:
+        @echo \\date\{`date +'%B %Y'`\} > date.inc
+
+preamble.inc:
+        cp -f preamble.$(PREAMBLETYPE) preamble.inc
+
+../compiler/msg2inc$(EXEEXT):
+	$(MAKE) -C ../compiler msg2inc
+
+messages.inc: ../compiler/msg2inc$(EXEEXT) ../compiler/msg/errore.msg
+        ../compiler/msg2inc -TE ../compiler/msg/errore.msg messages.inc
+
+# Local copy of the required styles
+syntax.sty: styles/syntax.sty
+        cp $(wildcard styles/*.*) .
+
+# Default includes needed for all docs
+INCLUDES=date.inc preamble.inc syntax.sty
+
+
+#####################################################################
+# Tex from XML
+#####################################################################
+
+# Where is System.pp located
+SYSTEMUNITDIR=$(OS_SOURCE)
+ifeq ($(findstring bsd,$(OS_SOURCE)),)
+override SYSTEMUNITDIR=bsd
+endif
+ifeq ($(findstring darwin,$(OS_SOURCE)),)
+override SYSTEMUNITDIR=bsd
+endif
+
+FCLOPTS=--package=fcl --descr=classes.xml --input='$(FPCSRCDIR)/rtl/$(HOSTOS)/classes.pp -Fi$(FPCSRCDIR)/rtl/objpas/classes'
+
+fcl.inc: classes.xml
+        $(FPDOC) --output=fcl.inc $(FCLOPTS) --format=latex
+
+RTLOPTS=--package=rtl --descr=rtl.xml
+ifndef CURRENTXMLONLY
+XMLUNITS=sysutils strutils dateutils systhrds strings mouse keyboard \
+         crt video dos sockets objects heaptrc mmx ipc printer typinfo \
+         ports getopts emu387 dxeload go32 gpm graph oldlinux baseunix \
+         unixtype unix classes unixutil x86 dynlibs linux math system\
+         objpas dateutils rtl
+RTLXML=$(addsuffix .xml,$(XMLUNITS))
+RTLOPTS+= --descr=strutils.xml --input="../rtl/objpas/strutils.pp"
+RTLOPTS+= --descr=systhrds.xml --input="../rtl/unix/systhrds.pp -Fi../rtl/inc"
+RTLOPTS+= --descr=sysutils.xml --input="../rtl/unix/sysutils.pp -Fi../rtl/objpas/sysutils -Fi../rtl/inc"
+RTLOPTS+= --descr=strings.xml --input="../rtl/inc/strings.pp -Fi../rtl/i386 -Fi../rtl/inc"
+RTLOPTS+= --descr=mouse.xml --input="../rtl/unix/mouse.pp -Fi../rtl/inc"
+RTLOPTS+= --descr=keyboard.xml --input="../rtl/unix/keyboard.pp -Fi../rtl/inc"
+RTLOPTS+= --descr=crt.xml --input="../rtl/unix/crt.pp -Fi../rtl/inc"
+RTLOPTS+= --descr=video.xml --input="../rtl/unix/video.pp -Fi../rtl/inc"
+RTLOPTS+= --descr=dos.xml --input="../rtl/unix/dos.pp -Fi../rtl/inc -dcpui386"
+RTLOPTS+= --descr=sockets.xml --input="-dver1_0 ../rtl/unix/sockets.pp -Fi../rtl/inc -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=objects.xml --input="../rtl/inc/objects.pp -Fi../rtl/i386 -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=heaptrc.xml --input="../rtl/inc/heaptrc.pp -Fi../rtl/i386 -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=mmx.xml --input="../rtl/i386/mmx.pp -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=ipc.xml --input="../rtl/unix/ipc.pp -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=printer.xml --input="../rtl/unix/printer.pp -Fi../rtl/$(HOSTOS) -Fi../rtl/inc"
+RTLOPTS+= --descr=typinfo.xml --input="../rtl/objpas/typinfo.pp -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=ports.xml --input="../rtl/unix/ports.pp -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=getopts.xml --input="../rtl/inc/getopts.pp -Fi../rtl/$(HOSTOS)"
+RTLOPTS+= --descr=emu387.xml --input="../rtl/go32v2/emu387.pp -Fi../rtl/i386"
+RTLOPTS+= --descr=dxeload.xml --input="../rtl/go32v2/dxeload.pp -Fi../rtl/i386"
+RTLOPTS+= --descr=go32.xml --input="../rtl/go32v2/go32.pp -Fi../rtl/i386"
+RTLOPTS+= --descr=gpm.xml --input="-dVER1_0 ../rtl/unix/gpm.pp -Fi../rtl/i386"
+RTLOPTS+= --descr=graph.xml --input="../rtl/unix/graph.pp -Fi../rtl/i386 -Fi../rtl/inc/graph"
+RTLOPTS+= --descr=oldlinux.xml --input="../rtl/unix/oldlinux.pp -Fi../rtl/linux -Fi../rtl/unix"
+RTLOPTS+= --descr=unixtype.xml --input="../rtl/unix/unixtype.pp -Fi../rtl/unix -Fi../rtl/linux -Fi../rtl/linux/i386"
+RTLOPTS+= --descr=baseunix.xml --input="../rtl/linux/baseunix.pp -Fi../rtl/unix -Fi../rtl/linux -Fi../rtl/linux/i386"
+RTLOPTS+= --descr=unix.xml  --input="../rtl/unix/unix.pp -Fi../rtl/unix -Fi../rtl/linux -Fi../rtl/linux/i386"
+RTLOPTS+= --descr=classes.xml --input='$(FPCSRCDIR)/rtl/$(HOSTOS)/classes.pp -Fi$(FPCSRCDIR)/rtl/objpas/classes'
+RTLOPTS+= --descr=unixutil.xml --input="../rtl/unix/unixutil.pp"
+RTLOPTS+= --descr=x86.xml --input="../rtl/unix/x86.pp"
+RTLOPTS+= --descr=dynlibs.xml --input="../rtl/inc/dynlibs.pp -Fi../rtl/unix"
+RTLOPTS+= --descr=linux.xml --input="../rtl/unix/linux.pp -Fi../rtl/linux -Fi../rtl/unix"
+RTLOPTS+= --descr=math.xml --input="../rtl/objpas/math.pp -Fi../rtl/i386 -dFPC_HAS_TYPE_EXTENDED"
+RTLOPTS+= --descr=system.xml --input="-dfpdocsystem -dHASGETHEAPSTATUS -dSUPPORT_DOUBLE ../rtl/$(SYSTEMUNITDIR)/system.pp -Fi../rtl/unix -Fi../rtl/inc -Fi../rtl/i386 -dCPU32 -dHASVARIANT -dFPC_HAS_TYPE_EXTENDED -dHASWIDECHAR"
+RTLOPTS+=--descr=objpas.xml --input="-dHASINTF ../rtl/objpas/objpas.pp"
+RTLOPTS+=--descr=dateutils.xml --input="../rtl/objpas/dateutils.pp -Fi../rtl/objpas"
+else
+RTLXML=dateutils.xml
+RTLOPTS+=--descr=dateutils.xml --input="../rtl/objpas/dateutils.pp -Fi../rtl/objpas"
+endif
+
+rtl.inc: $(RTLXML)
+        $(FPDOC) --output=rtl.inc $(RTLOPTS) --format=latex
+
+
+#####################################################################
+# DVI files
+#####################################################################
+
+ref.dvi: ref.tex $(INCLUDES)
+
+prog.dvi: prog.tex $(INCLUDES)
+
+user.dvi: user.tex $(INCLUDES) messages.inc
+
+fpdoc.dvi: fpdoc.tex $(INCLUDES)
+
+fcl.dvi: fcl.tex fcl.inc $(INCLUDES)
+
+chart.dvi: chart.tex
+
+
+ref.pdf: ref.tex $(INCLUDES)
+
+user.pdf: user.tex $(INCLUDES) messages.inc
+
+prog.pdf: prog.tex $(INCLUDES)
+
+onechap.pdf: onechap.tex $(INCLUDES)
+
+onechap.dvi: onechap.tex $(INCLUDES)
+
+fpdoc.pdf: fpdoc.tex $(INCLUDES)
+
+fcl.pdf: fcl.tex fcl.inc $(INCLUDES)
+
+chart.pdf: chart.tex
+
+rtl.dvi: rtl.tex rtl.inc $(INCLUDES)
+
+rtl.pdf: rtl.tex rtl.inc $(INCLUDES)
+
+dvi : $(DVI)
+
+txt : dvi $(TXT)
+
+ps : dvi $(PS)
+
+pdf : $(PDF)
+
+all : dvi ps pdf txt html
+
+
+#######################################################################
+# HTML creation
+#######################################################################
+
+.PHONY: htex user prog onechap ref internal html hevea
+
+ifdef INSTALLDEBUG
+#######################################################################
+# Installation debugging
+$(HTML):
+        mkdir $@
+        cp [email protected] $@/index.html
+html: $(HTML)
+else
+#######################################################################
+# Automatic selection. Default tex4ht
+ifdef USEHEVEA
+include Makefile.hev
+else
+ifdef USEL2H
+include Makefile.l2h
+else
+include Makefile.4ht
+endif  # USEL2H
+endif  # USEHEVEA
+endif  # INSTALLDEBUG
+#######################################################################
+# Targets to force using a specific tool.
+hevea:
+        $(MAKE) html USEHEVEA=1
+l2h:
+        $(MAKE) html USEL2H=1
+4ht:
+        $(MAKE) html USETEX4HT=1
+
+fcl: fcl/index.html
+
+fcl/index.html: classes.xml
+        $(FPDOC) $(FCLOPTS) --format=html --output=fcl
+
+rtl: rtl/index.html
+
+rtl/index.html: $(RTLXML)
+        $(FPDOC) $(RTLOPTS) --format=html --output=rtl
+
+#####################################################################
+# GTK Articles
+#####################################################################
+
+GTKPDF=$(addsuffix .pdf,$(addprefix gtk, 1 2 3 4 5))
+
+gtk: $(GTKPDF)
+
+gtk1.pdf: gtk1.tex
+
+gtk2.pdf: gtk2.tex
+
+gtk3.pdf: gtk3.tex
+
+gtk4.pdf: gtk4.tex
+
+gtk5.pdf: gtk5.tex
+
+
+#####################################################################
+# Installation
+#####################################################################
+
+.PHONY: pdfinstall psinstall dviinstall txtinstall
+
+pdfinstall: pdf
+        install -d -m 755 $(INSTALL_DOCDIR)
+        cp $(PDF) $(INSTALL_DOCDIR)
+
+psinstall: ps
+        install -d -m 755 $(INSTALL_DOCDIR)
+        cp $(PS) $(INSTALL_DOCDIR)
+
+dviinstall: dvi
+        install -d -m 755 $(INSTALL_DOCDIR)
+        cp $(DVI) $(INSTALL_DOCDIR)
+
+txtinstall: txt
+        install -d -m 755 $(INSTALL_DOCDIR)
+        cp $(TXT) $(INSTALL_DOCDIR)
+
+htmlinstall: html
+        install -d -m 755 $(INSTALL_DOCDIR)
+        cp fpctoc.html $(INSTALL_DOCDIR)
+        cp -R buttons $(INSTALL_DOCDIR)
+        cp -R pics $(INSTALL_DOCDIR)
+        cp -R $(HTML) $(INSTALL_DOCDIR)
+        find $(INSTALL_DOCDIR) -name 'CVS' -or -name '*.eps' | xargs -n1 rm -rf
+
+install:
+        @echo Choose install from:
+        @echo pdfinstall,htmlinstall,htmldosinstall
+        @exit
+
+#####################################################################
+# Archives
+#####################################################################
+
+psdist:
+        $(MAKE) zipinstall ZIPTARGET=psinstall
+
+pdftar:
+        $(MAKE) zipinstall ZIPTARGET=pdfinstall UNIXHier=1 USETAR=y
+
+pdfzip:
+        $(MAKE) zipinstall ZIPTARGET=pdfinstall UNIXHier= USEZIP=y
+
+dvidist:
+        $(MAKE) zipinstall ZIPTARGET=dviinstall
+
+txtdist:
+        $(MAKE) zipinstall ZIPTARGET=txtinstall
+
+htmltar:
+        $(MAKE) zipinstall ZIPTARGET=htmlinstall USETAR=y
+
+htmlzip:
+        $(MAKE) zipinstall ZIPTARGET=htmlinstall UNIXHier= USEZIP=y
+
+pdfdist: pdfzip pdftar
+
+htmldist: htmlzip htmltar
+
+alldist: dvidist psdist txtdist pdfdist htmldist
+
+#####################################################################
+# Zips of htmls
+#####################################################################
+
+DOCPREFIX=doc
+BASEDIR=$(shell pwd)
+
+# html only, no htm
+
+#####################################################################
+# Examples
+#####################################################################
+
+examples:
+        $(MAKE) -C crtex
+        $(MAKE) -C dosex
+        $(MAKE) -C optex
+        $(MAKE) -C mathex
+        $(MAKE) -C printex
+        $(MAKE) -C progex
+        $(MAKE) -C refex
+        $(MAKE) -C stringex
+        $(MAKE) -C objectex
+        $(MAKE) -C sysutex
+        $(MAKE) -C typinfex
+        $(MAKE) -C kbdex
+
+cleanexamples:
+        $(MAKE) -C crtex clean
+        $(MAKE) -C dosex clean
+        $(MAKE) -C optex clean
+        $(MAKE) -C mathex clean
+        $(MAKE) -C printex clean
+        $(MAKE) -C progex clean
+        $(MAKE) -C refex clean
+        $(MAKE) -C stringex clean
+        $(MAKE) -C objectex clean
+        $(MAKE) -C sysutex clean
+        $(MAKE) -C typinfex clean
+        $(MAKE) -C kbdex clean
+
+dosexamples: examples
+        $(MAKE) -C go32ex
+        $(MAKE) -C mouseex
+
+linuxexamples: examples
+        $(MAKE) -C linuxex
+        $(MAKE) -C sockex
+        $(MAKE) -C ipcex
+
+execute:
+        $(MAKE) -C dosex all
+        $(MAKE) -C dosex execute
+        $(MAKE) -C refex all
+        $(MAKE) -C refex execute
+        $(MAKE) -C mathex all
+        $(MAKE) -C mathex execute
+        $(MAKE) -C stringex all
+        $(MAKE) -C stringex execute
+        $(MAKE) -C objectex all
+        $(MAKE) -C objectex execute
+        $(MAKE) -C sysutex all
+        $(MAKE) -C sysutex execute
+        $(MAKE) -C typinfex all
+        $(MAKE) -C typinfex execute
+
+
+#
+# $Log$
+# Revision 1.1  2005-01-09 20:14:33  peter
+#   * build messages.inc from errore.msg
+#   * new zip and tar targets
+#   * use fpcmake generated Makefile
+#
+# Revision 1.38  2004/12/30 13:48:53  michael
+# + Fixed warnings, completed dateutils
+#
+# Revision 1.37  2004/12/22 08:47:31  marco
+#  * bsd system unit location fix. Hope it works for Darwin too
+#
+# Revision 1.36  2004/12/21 22:58:24  michael
+# + Added dateutils functions
+#
+# Revision 1.35  2004/12/19 20:20:16  peter
+#   * includes variable instead of target to prevent always rebuilding
+#   * also build fcl.pdf
+#
+# Revision 1.34  2004/12/15 22:14:14  michael
+# + Make targets fixed (hopefully)
+#

+ 0 - 1513
docs/messages.tex

@@ -1,1513 +0,0 @@
- \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
- controlled with the various verbosity level \var{-v} switches.
- \begin{description}
-\item [Compiler: arg1]
- When the \var{-vt} switch is used, this line tells you what compiler
- is used.
-\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]
- When the \var{-vd} switch is used, this line tells you what the target
- operating system is.
-\item [Using executable path: arg1]
- When the \var{-vt} switch is used, this line tells you where the compiler
- 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}
-\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).
- You can set this path with the \var{-I} option.
-\item [Using library path: arg1]
- When the \var{-vt} switch is used, this line tells you where the compiler
- looks for the libraries. You can set this path with the \var{-Fl} option.
-\item [Using object path: arg1]
- When the \var{-vt} switch is used, this line tells you where the compiler
- looks for object files you link in (files used in \var{\{\$L xxx\}} statements).
- You can set this path with the \var{-Fo} option.
-\item [Info: arg1 Lines compiled, arg2 sec]
- When the \var{-vi} switch is used, the compiler reports the number
- of lines compiled, and the time it took to compile them (real time,
- not program time).
-\item [Fatal: No memory left]
- The compiler doesn't have enough memory to compile your program. There are
- several remedies for this:
- \begin{itemize}
- \item If you're using the build option of the compiler, try compiling the
- different units manually.
- \item If you're compiling a huge program, split it up in units, and compile
- these separately.
- \item If the previous two don't work, recompile the compiler with a bigger
- heap (you can use the \var{-Ch} option for this, \seeo{Ch})
- \end{itemize}
-\item [Info: Writing Resource String Table file: arg1]
- This message is shown when the compiler writes the Resource String Table
- file containing all the resource strings for a program.
-\item [Error: Writing Resource String Table file: arg1]
- This message is shown when the compiler encountered an error when writing
- the Resource String Table file
-\item [Info: Fatal:]
- Prefix for Fatal Errors
-\item [Info: Error:]
- Prefix for Errors
-\item [Info: Warning:]
- Prefix for Warnings
-\item [Info: Note:]
- Prefix for Notes
-\item [Info: Hint:]
- Prefix for Hints
- \end{description}
- \section{Scanner messages.}
- This section lists the messages that the scanner emits. The scanner takes
- care of the lexical structure of the pascal file, i.e. it tries to find
- reserved words, strings, etc. It also takes care of directives and
- conditional compiling handling.
- \begin{description}
-\item [Fatal: Unexpected end of file]
- this typically happens in one of the following cases :
- \begin{itemize}
- \item The source file ends before the final \var{end.} statement. This
- happens mostly when the \var{begin} and \var{end} statements aren't
- balanced;
- \item An include file ends in the middle of a statement.
- \item A comment wasn't closed.
- \end{itemize}
-\item [Fatal: String exceeds line]
- You forgot probably to include the closing ' in a string, so it occupies
- multiple lines.
-\item [Fatal: illegal character arg1 (arg2)]
- An illegal character was encountered in the input file.
-\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.
-\item [Start reading includefile arg1]
- When you provide the \var{-vt} switch, the compiler tells you
- when it starts reading an included file.
-\item [Warning: Comment level arg1 found]
- When the \var{-vw} switch is used, then the compiler warns you if
- it finds nested comments. Nested comments are not allowed in Turbo Pascal
- and can be a possible source of errors.
-\item [Note: \$F 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]
- 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]
- With \var{-vn} on, the compiler warns if it ignores a switch
-\item [Warning: Illegal compiler switch arg1]
- You included a compiler switch (i.e. \var{\{\$... \}}) which the compiler
- doesn't know.
-\item [Warning: This compiler switch has a global effect]
- When \var{-vw} is used, the compiler warns if a switch is global.
-\item [Error: Illegal char constant]
- This happens when you specify a character with its ASCII code, as in
- \var{\#96}, but the number is either illegal, or out of range. The range
- is 1-255.
-\item [Fatal: Can't open file arg1]
- \fpc cannot find the program or unit source file you specified on the
- command line.
-\item [Fatal: Can't open include file arg1]
- \fpc cannot find the source file you specified in a \var{\{\$include ..\}}
- statement.
-\item [Error: Too many \$ENDIFs or \$ELSEs]
- Your \var{\{\$IFDEF ..\}} and {\{\$ENDIF\}} statements aren't balanced.
-\item [Warning: Records fields can be aligned to 1,2,4,8,16 or 32 bytes only]
- You are specifying the \var{\{\$PACKRECORDS n\} } with an illegal value for
- \var{n}. Only 1, 2, 4, 8, 16 and 32 are valid in this case.
-\item [Warning: Enumerated can be saved in 1,2 or 4 bytes only]
- You are specifying the \var{\{\$PACKENUM n\}} with an illegal value for
- \var{n}. Only 1,2 or 4 are valid in this case.
-\item [Error: \$ENDIF expected for arg1 arg2 defined in line arg3]
- Your conditional compilation statements are unbalanced.
-\item [Error: Syntax error while parsing a conditional compiling expression]
- There is an error in the expression following the \var{\{\$if ..\}} compiler
- directive.
-\item [Error: Evaluating a conditional compiling expression]
- There is an error in the expression following the \var{\{\$if ..\}} compiler
- directive.
-\item [Warning: Macro contents is cut after char 255 to evalute expression]
- The contents of macros canno be longer than 255 characters. This is a
- safety in the compiler, to prevent buffer overflows. This is shown as a
- warning, i.e. when the \var{-vw} switch is used.
-\item [Error: ENDIF without IF(N)DEF]
- Your \var{\{\$IFDEF ..\}} and {\{\$ENDIF\}} statements aren't balanced.
-\item [Fatal: User defined: arg1]
- A user defined fatal error occurred. see also the \progref
-\item [Error: User defined: arg1]
- A user defined error occurred. see also the \progref
-\item [Warning: User defined: arg1]
- A user defined warning occurred. see also the \progref
-\item [Note: User defined: arg1]
- A user defined note was encountered. see also the \progref
-\item [Hint: User defined: arg1]
- A user defined hint was encountered. see also the \progref
-\item [Info: User defined: arg1]
- User defined information was encountered. see also the \progref
-\item [Error: Keyword redefined as macro has no effect]
- You cannot redefine keywords with macros.
-\item [Fatal: Macro buffer overflow while reading or expanding a macro]
- Your macro or it's result  was too long for the compiler.
-\item [Warning: Extension of macros exceeds a deep of 16.]
- When expanding a macro macros have been nested to a level of 16.
- The compiler will expand no further, since this may be a sign that
- recursion is used.
-\item [Error: compiler switches aren't allowed in (* ... *) styled comments]
- Compiler switches should always be between \var{\{ \}} comment delimiters.
-\item [Handling switch "arg1"]
- When you set debugging info on (\var{-vd}) the compiler tells you when it
- is evaluating conditional compile statements.
-\item [ENDIF arg1 found]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements.
-\item [IFDEF arg1 found, arg2]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements.
-\item [IFOPT arg1 found, arg2]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements.
-\item [IF arg1 found, arg2]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements.
-\item [IFNDEF arg1 found, arg2]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements.
-\item [ELSE arg1 found, arg2]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements.
-\item [Skipping until...]
- When you turn on conditional messages(\var{-vc}), the compiler tells you
- where it encounters conditional statements, and whether it is skipping or
- compiling parts.
-\item [Info: Press <return> to continue]
- When the \var{-vi} switch is used, the compiler stops compilation
- and waits for the \var{Enter} key to be pressed when it encounters
- a \var{\{\$STOP\}} directive.
-\item [Warning: Unsupported switch arg1]
- When warings are turned on (\var{-vw}) the compiler warns you about
- unsupported switches. This means that the switch is used in Delphi or
- Turbo Pascal, but not in \fpc
-\item [Warning: Illegal compiler directive arg1]
- When warings are turned on (\var{-vw}) the compiler warns you about
- unrecognised switches. For a list of recognised switches, \progref
-\item [Back in arg1]
- When you use (\var{-vt}) the compiler tells you when it has finished
- reading an include file.
-\item [Warning: Unsupported application type: arg1]
- You get this warning, ff you specify an unknown application type
- with the directive \var{\{\$APPTYPE\}}
-\item [Warning: APPTYPE isn't support by the target OS]
- The \var{\{\$APPTYPE\}} directive is supported by win32 applications only.
-\item [Warning: DESCRIPTION is only supported for OS2 and Win32]
- The \var{\{\$DESCRIPTION\}} directive is only supported for OS2 and Win32 targets.
-\item [Note: VERSION is not supported by target OS.]
- The \var{\{\$VERSION\}} directive is only supported by win32 target.
-\item [Note: VERSION only for exes or DLLs]
- The \var{\{\$VERSION\}} directive is only used for executable or DLL sources.
-\item [Warning: Wrong format for VERSION directive arg1]
- The \var{\{\$VERSION\}} directive format is majorversion.minorversion
- where majorversion and minorversion are words.
-\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]
- 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.
-\item [Error: Wrong switch toggle, use ON/OFF or +/-]
- You need to use ON or OFF or a + or - to toggle the switch
-\item [Error: Resource files are not supported for this target]
- The target you are compiling for doesn't support resource files. The
- only targets which can use resource files are Win32 and OS/2 (EMX) currently
-\item [Warning: Include environment arg1 not found in environment]
- The included environment variable can't be found in the environment, it'll
- be replaced by an empty string instead.
-\item [Error: Illegal value for FPU register limit]
- Valid values for this directive are 0..8 and NORMAL/DEFAULT
-\item [Warning: Only one resource file is supported for this target]
- The target you are compiling for supports only one resource file. This is the
- case of OS/2 (EMX) currently. The first resource file found is used, the
- others are discarded.
-\item [Warning: Macro support has been turned off]
- A macro declaration has been found, but macro support is currently off,
- so the declaration will be ignored. To turn macro support on compile with
- -Sm on the commandline or add \var{\{\$MACRO ON\}} in the source
-\item [Warning: APPID is only supported for PalmOS]
- The \var{\{\$APPID\}} directive is only supported for the PalmOS target.
-\item [Warning: APPNAME is only supported for PalmOS]
- The \var{\{\$APPNAME\}} directive is only supported for the PalmOS target.
-\item [Error: Constant strings can't be longer than 255 chars]
- A single string constant can contain at most 255 chars. Try splitting up the
- string in multiple smaller parts and concatenate them with a + operator.
- \end{description}
- \section{Parser messages}
- This section lists all parser messages. The parser takes care of the
- semantics of you language, i.e. it determines if your pascal constructs
- are correct.
- \begin{description}
-\item [Error: Parser - Syntax Error]
- An error against the Turbo Pascal language was encountered. This happens
- typically when an illegal character is found in the sources file.
-\item [Warning: Procedure type FAR ignored]
- This is a warning. \var{FAR} is a construct for 8 or 16 bit programs. Since
- the compile generates 32 bit programs, it ignores this directive.
-\item [Warning: Procedure type NEAR ignored]
- This is a warning. \var{NEAR} is a construct for 8 or 16 bit programs. Since
- the compile generates 32 bit programs, it ignores this directive.
-\item [Warning: Procedure type INTERRUPT ignored for not i386]
- This is a warning. \var{INTERRUPT} is a i386 specific construct
- and is ignored for other processors.
-\item [Error: INTERRUPT procedure can't be nested]
- An \var{INTERRUPT} procedure must be global.
-\item [Warning: Procedure type arg1 ignored]
- This is a warning. \var{REGISTER},\var{REINTRODUCE} is ignored by FPC programs for now.
- This is introduced first for Delphi compatibility.
-\item [Error: Not all declarations of arg1 are declared with OVERLOAD]
- When you want to use overloading using the \var{OVERLOAD} directive, then
- all declarations need to have \var{OVERLOAD} specified.
-\item [Error: No DLL File specified]
- No longer in use.
-\item [Error: Duplicate exported function name arg1]
- Exported function names inside a specific DLL must all be different
-\item [Error: Duplicate exported function index arg1]
- Exported function names inside a specific DLL must all be different
-\item [Error: Invalid index for exported function]
- DLL function index must be in the range \var{1..\$FFFF}
-\item [Warning: Relocatable DLL or executable arg1 debug info does not work, disabled.]
-\item [Warning: To allow debugging for win32 code you need to disable relocation with -WN option]
- Stabs info is wrong for relocatable DLL or EXES use -WN
- if you want to debug win32 executables.
-\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}).
-\item [Error: Destructor name must be DONE]
- You are declaring a destructor with a name which isn't \var{done}, and the
- \var{-Ss} switch is in effect. See the \var{-Ss} switch (\seeo{Ss}).
-\item [Error: Illegal open parameter]
- You are trying to use the wrong type for an open parameter.
-\item [Error: Procedure type INLINE not supported]
- You tried to compile a program with C++ style inlining, and forgot to
- specify the \var{-Si} option (\seeo{Si}). The compiler doesn't support C++
- styled inlining by default.
-\item [Warning: Private methods shouldn't be VIRTUAL]
- You declared a method in the private part of a object (class) as
- \var{virtual}. This is not allowed. Private methods cannot be overridden
- anyway.
-\item [Warning: Constructor should be public]
- Constructors must be in the 'public' part of an object (class) declaration.
-\item [Warning: Destructor should be public]
- Destructors must be in the 'public' part of an object (class) declaration.
-\item [Note: Class should have one destructor only]
- You can declare only one destructor for a class.
-\item [Error: Local class definitions are not allowed]
- Classes must be defined globally. They cannot be defined inside a
- procedure or function
-\item [Fatal: Anonym class definitions are not allowed]
- An invalid object (class) declaration was encountered, i.e. an
- object or class without methods that isn't derived from another object or
- class. For example:
- \begin{verbatim}
- Type o = object
-          a : longint;
-          end;
- \end{verbatim}
- will trigger this error.
-\item [Error: The object arg1 has no VMT]
-\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 no. arg1]
- 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]
- There is an error in the parameter list of the function or procedure,
- the number of parameters is not correct.
-\item [Error: overloaded identifier arg1 isn't a function]
- The compiler encountered a symbol with the same name as an overloaded
- function, but it isn't a function it can overload.
-\item [Error: overloaded functions have the same parameter list]
- You're declaring overloaded functions, but with the same parameter list.
- Overloaded function must have at least 1 different parameter in their
- declaration.
-\item [Error: function header doesn't match the forward declaration arg1]
- You declared a function with same parameters but
- different result type or function modifiers.
-\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: Values in enumeration types have to be ascending]
- \fpc allows enumeration constructions as in C. Given the following
- declaration two declarations:
- \begin{verbatim}
- type a = (A_A,A_B,A_E:=6,A_UAS:=200);
- type a = (A_A,A_B,A_E:=6,A_UAS:=4);
- \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 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).
-\item [Error: With can not be used for variables in a different segment]
- With stores a variable locally on the stack,
- but this is not possible if the variable belongs to another segment.
-\item [Error: function nesting > 31]
- You can nest function definitions only 31 times.
-\item [Error: range check error while evaluating constants]
- The constants are out of their allowed range.
-\item [Warning: range check error while evaluating constants]
- The constants are out of their allowed range.
-\item [Error: duplicate case label]
- You are specifying the same label 2 times in a \var{case} statement.
-\item [Error: Upper bound of case range is less than lower bound]
- The upper bound of a \var{case} label is less than the lower bound and this
- is useless
-\item [Error: typed constants of classes are not allowed]
- You cannot declare a constant of type class or object.
-\item [Error: functions variables of overloaded functions are not allowed]
- You are trying to assign an overloaded function to a procedural variable.
- This isn't allowed.
-\item [Error: string length must be a value from 1 to 255]
- 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 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,
- i.e., a object or class method, but the type in front of the dot is not
- a known type.
-\item [Error: type identifier not allowed here]
- You cannot use a type inside an expression.
-\item [Error: method identifier expected]
- This identifier is not a method.
- This happens when the compiler scans a procedure declaration that contains
- a dot, i.e., a object or class method, but the procedure name is not a
- procedure of this type.
-\item [Error: function header doesn't match any method of this class arg1]
- This identifier is not a method.
- This happens when the compiler scans a procedure declaration that contains
- a dot, i.e., a object or class method, but the procedure name is not a
- procedure of this type.
-\item [procedure/function arg1]
- When using the \var{-vp} switch, the compiler tells you when it starts
- processing a procedure or function implementation.
-\item [Error: Illegal floating point constant]
- The compiler expects a floating point expression, and gets something else.
-\item [Error: FAIL can be used in constructors only]
- You are using the \var{FAIL} instruction outside a constructor method.
-\item [Error: Destructors can't have parameters]
- You are declaring a destructor with a parameter list. Destructor methods
- cannot have parameters.
-\item [Error: Only class methods can be referred with class references]
- This error occurs in a situation like the following:
- \begin{verbatim}
- Type :
-    Tclass = Class of Tobject;
-
- Var C : TClass;
-
- begin
- ...
- C.free
- \end{verbatim}
- \var{Free} is not a class method and hence cannot be called with a class
- reference.
-\item [Error: Only class methods can be accessed in class methods]
- This is related to the previous error. You cannot call a method of an object
- from a inside a class method. The following code would produce this error:
- \begin{verbatim}
- class procedure tobject.x;
-
- begin
-   free
- \end{verbatim}
- Because free is a normal method of a class it cannot be called from a class
- method.
-\item [Error: Constant and CASE types do not match]
- One of the labels is not of the same type as the case variable.
-\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: 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;
- you will not override it.
-\item [Error: There is no method in an ancestor class to be overridden: arg1]
- You try to \var{override} a virtual method of a parent class that doesn't
- exist.
-\item [Error: No member is provided to access property]
- You specified no \var{read} directive for a property.
-\item [Warning: Stored prorperty directive is not yet implemented]
- The \var{stored} directive is not yet implemented
-\item [Error: Illegal symbol for property access]
- There is an error in the \var{read} or \var{write} directives for an array
- property. When you declare an array property, you can only access it with
- procedures and functions. The following code woud cause such an error.
- \begin{verbatim}
- tmyobject = class
-   i : integer;
-   property x [i : integer]: integer read I write i;
- \end{verbatim}
-
-\item [Error: Cannot access a protected field of an object here]
- Fields that are declared in a \var{protected} section of an object or class
- declaration cannot be accessed outside the module wher the object is
- defined, or outside descendent object methods.
-\item [Error: Cannot access a private field of an object here]
- Fields that are declared in a \var{private} section of an object or class
- declaration cannot be accessed outside the module where the class is
- defined.
-\item [Warning: overloaded method of virtual method should be virtual: arg1]
- If you declare overloaded methods in a class, then they should either all be
- virtual, or none. You shouldn't mix them.
-\item [Warning: overloaded method of non-virtual method should be non-virtual: arg1]
- If you declare overloaded methods in a class, then they should either all be
- virtual, or none. You shouldn't mix them.
-\item [Error: overloaded methods which are virtual must have the same return type: arg1]
- If you declare virtual overloaded methods in a class definition, they must
- have the same return type.
-\item [Error: EXPORT declared functions can't be nested]
- You cannot declare a function or procedure within a function or procedure
- that was declared as an export procedure.
-\item [Error: methods can't be EXPORTed]
- You cannot declare a procedure that is a method for an object as
- \var{export}ed. That is, your methods cannot be called from a C program.
-\item [Error: call by var parameters have to match exactly: Got arg1 expected arg2]
- When calling a function declared with \var{var} parameters, the variables in
- the function call must be of exactly the same type. There is no automatic
- type conversion.
-\item [Error: Class isn't a parent class of the current class]
- When calling inherited methods, you are trying to call a method of a strange
- class. You can only call an inherited method of a parent class.
-\item [Error: SELF is only allowed in methods]
- You are trying to use the \var{self} parameter outside an object's method.
- Only methods get passed the \var{self} parameters.
-\item [Error: methods can be only in other methods called direct with type identifier of the class]
- A construction like \var{sometype.somemethod} is only allowed in a method.
-\item [Error: Illegal use of ':']
- You are using the format \var{:} (colon) 2 times on an expression that
- is not a real expression.
-\item [Error: range check error in set constructor or duplicate set element]
- The declaration of a set contains an error. Either one of the elements is
- outside the range of the set type, either two of the elements are in fact
- the same.
-\item [Error: Pointer to object expected]
- You specified an illegal type in a \var{New} statement.
- The extended synax of \var{New} needs an  object as a parameter.
-\item [Error: Expression must be constructor call]
- When using the extended syntax of \var{new}, you must specify the constructor
- method of the object you are trying to create. The procedure you specified
- is not a constructor.
-\item [Error: Expression must be destructor call]
- When using the extended syntax of \var{dispose}, you must specify the
- destructor method of the object you are trying to dispose of.
- The procedure you specified is not a destructor.
-\item [Error: Illegal order of record elements]
- When declaring a constant record, you specified the fields in the wrong
- order.
-\item [Error: Expression type must be class or record type]
- 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: 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.
-\item [Error: constructors and destructors must be methods]
- You're declaring a procedure as destructor or constructor, when the
- procedure isn't a class method.
-\item [Error: Operator is not overloaded]
- You're trying to use an overloaded operator when it isn't overloaded for
- this type.
-\item [Error: Impossible to overload assignment for equal types]
- You can not overload assignment for types
- that the compiler considers as equal.
-\item [Error: Impossible operator overload]
- The combination of operator, arguments and return type are
- incompatible.
-\item [Error: Re-raise isn't possible there]
- You are trying to raise an exception where it isn't allowed. You can only
- raise exceptions in an \var{except} block.
-\item [Error: The extended syntax of new or dispose isn't allowed for a class]
- You cannot generate an instance of a class with the extended syntax of
- \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 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]
- When using the \var{-So} switch, procedure overloading is switched off.
- Turbo Pascal does not support function overloading.
-\item [Error: It is not possible to overload this operator (overload = instead)]
- You are trying to overload an operator which cannot be overloaded.
- The following operators can be overloaded :
- \begin{verbatim}
-    +, -, *, /, =, >, <, <=, >=, is, as, in, **, :=
- \end{verbatim}
-\item [Error: Comparative operator must return a boolean value]
- When overloading the \var{=} operator, the function must return a boolean
- value.
-\item [Error: Only virtual methods can be abstract]
- You are declaring a method as abstract, when it isn't declared to be
- virtual.
-\item [Fatal: Use of unsupported feature!]
- You're trying to force the compiler into doing something it cannot do yet.
-\item [Error: The mix of CLASSES and OBJECTS isn't allowed]
- You cannot derive \var{objects} and \var{classes} intertwined . That is,
- a class cannot have an object as parent and vice versa.
-\item [Warning: Unknown procedure directive had to be ignored: arg1]
- The procedure direcive you secified is unknown. Recognised procedure
- directives are \var{cdecl}, \var{stdcall}, \var{popstack}, \var{pascal}
- \var{register}, \var{export}.
-\item [Error: absolute can only be associated to ONE variable]
- You cannot specify more than one variable before the \var{absolute} directive.
- Thus, the following construct will provide this error:
- \begin{verbatim}
- Var Z : Longint;
-     X,Y : Longint absolute Z;
- \end{verbatim}
- \item [ absolute can only be associated a var or const ]
- The address of a \var{absolute} directive can only point to a variable or
- constant. Therefore, the following code will produce this error:
- \begin{verbatim}
-   Procedure X;
-
-  var p : longint absolute x;
- \end{verbatim}
-
-\item [Error: absolute can only be associated a var or const]
- The address of a \var{absolute} directive can only point to a variable or
- constant. Therefore, the following code will produce this error:
- \begin{verbatim}
-   Procedure X;
-
-  var p : longint absolute x;
- \end{verbatim}
-
-\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)]
- You are defining a overloaded function in the implementation part of a unit,
- but there is no corresponding declaration in the interface part of the unit.
-\item [Warning: Virtual methods are used without a constructor in arg1]
- If you declare objects or classes that contain virtual methods, you need
- to have a constructor and destructor to initialize them. The compiler
- encountered an object or class with virtual methods that doesn't have
- a constructor/destructor pair.
-\item [Macro defined: arg1]
- When \var{-vm} is used, the compiler tells you when it defines macros.
-\item [Macro undefined: arg1]
- When \var{-vm} is used, the compiler tells you when it undefines macros.
-\item [Macro arg1 set to arg2]
- When \var{-vm} is used, the compiler tells you what values macros get.
-\item [Info: Compiling arg1]
- When you turn on information messages (\var{-vi}), the compiler tells you
- what units it is recompiling.
-\item [Parsing interface of unit arg1]
- This tells you that the reading of the interface
- of the current unit starts
-\item [Parsing implementation of arg1]
- This tells you that the code reading of the implementation
- of the current unit, library or program starts
-\item [Compiling arg1 for the second time]
- When you request debug messages (\var{-vd}) the compiler tells you what
- units it recompiles for the second time.
-\item [Error: Array properties aren't allowed here]
- You cannot use array properties at that point in the source.
-\item [Error: No property found to override]
- You want to overrride a property of a parent class, when there is, in fact,
- no such property in the parent class.
-\item [Error: Only one default property is allowed, found inherited default property in class arg1]
- You specified a property as \var{Default}, but a parent class already has a
- default property, and a class can have only one default property.
-\item [Error: The default property must be an array property]
- Only array properties of classes can be made \var{default} properties.
-\item [Error: Virtual constructors are only supported in class object model]
- You cannot have virtual constructors in objects. You can only have them
- in classes.
-\item [Error: No default property available]
- You try to access a default property of a class, but this class (or one of
- it's ancestors) doesn't have a default property.
-\item [Error: The class can't have a published section, use the {\$M+} switch]
- If you want a \var{published} section in a class definition, you must
- use the \var{\{\$M+\}} switch, whch turns on generation of type
- information.
-\item [Error: Forward declaration of class arg1 must be resolved here to use the class as ancestor]
- To be able to use an object as an ancestor object, it must be defined
- first. This error occurs in the following situation:
- \begin{verbatim}
-  Type ParentClas = Class;
-       ChildClass = Class(ParentClass)
-         ...
-       end;
- \end{verbatim}
- Where \var{ParentClass} is declared but not defined.
-\item [Error: Local operators not supported]
- You cannot overload locally, i.e. inside procedures or function
- definitions.
-\item [Error: Procedure directive arg1 not allowed in interface section]
- This procedure directive is not allowed in the \var{interface} section of
- a unit. You can only use it in the \var{implementation} section.
-\item [Error: Procedure directive arg1 not allowed in implementation section]
- This procedure directive is not defined in the \var{implementation} section of
- a unit. You can only use it in the \var{interface} section.
-\item [Error: Procedure directive arg1 not allowed in procvar declaration]
- This procedure directive cannot be part of a procedural or function
- type declaration.
-\item [Error: Function is already declared Public/Forward arg1]
- You will get this error if a function is defined as \var{forward} twice.
- Or it is once in the \var{interface} section, and once as a \var{forward}
- declaration in the \var{implmentation} section.
-\item [Error: Can't use both EXPORT and EXTERNAL]
- These two procedure directives are mutually exclusive
-\item [Error: NAME keyword expected]
- The definition of an external variable needs a \var{name} clause.
-\item [Warning: arg1 not yet supported inside inline procedure/function]
- Inline procedures don't support this declaration.
-\item [Warning: Inlining disabled]
- Inlining of procedures is disabled.
-\item [Info: Writing Browser log arg1]
- When information messages are on, the compiler warns you when it
- writes the browser log (generated with the \var{\{\$Y+ \}} switch).
-\item [Hint: Maybe pointer dereference is missing]
- The compiler thinks that a pointer may need a dereference.
-\item [Fatal: Selected assembler reader not supported]
- The selected assembler reader (with \var{\{\$ASMMODE xxx\}} is not
- supported. The compiler can be compiled with or without support for a
- particular assembler reader.
-\item [Error: Procedure directive arg1 has conflicts with other directives]
- You specified a procedure directive that conflicts with other directives.
- for instance \var{cdecl} and \var{pascal} are mutually exclusive.
-\item [Error: Calling convention doesn't match forward]
- This error happens when you declare a function or procedure with
- e.g. \var{cdecl;} but omit this directive in the implementation, or vice
- versa. The calling convention is part of the function declaration, and
- must be repeated in the function definition.
-\item [Error: Register calling (fastcall) not supported]
- The \var{register} calling convention, i.e., arguments are passed in
- registers instead of on the stack is not supported. Arguments are always
- passed on the stack.
-\item [Error: Property can't have a default value]
- Set properties or indexed properties cannot have a default value.
-\item [Error: The default value of a property must be constant]
- The value of a \var{default} declared property must be known at compile
- time. The value you specified is only known at run time. This happens
- .e.g. if you specify a variable name as a default value.
-\item [Error: Symbol can't be published, can be only a class]
- Only class type variables can be in a \var{published} section of a class
- if they are not declared as a property.
-\item [Error: That kind of property can't be published]
- Properties in a \var{published} section cannot be array properties.
- they must be moved to public sections. Properties in a \var{published}
- section must be an ordinal type, a real type, strings or sets.
-\item [Warning: Empty import name specified]
- Both index and name for the import are 0 or empty
-\item [Warning: An import name is required]
- Some targets need a name for the imported procedure or a cdecl specifier
-\item [Error: Function internal name changed after use of function]
- This is an internal error; please report any occurrences of this error
- to the \fpc team.
-\item [Error: Division by zero]
- There is a divsion by zero encounted
-\item [Error: Invalid floating point operation]
- An operation on two real type values produced an overflow or a division
- by zero.
-\item [Error: Upper bound of range is less than lower bound]
- The upper bound of a \var{case} label is less than the lower bound and this
- is not possible
-\item [Warning: string "arg1" is longer than arg2]
- The size of the constant string is larger than the size you specified in
- string type definition
-\item [Error: string length is larger than array of char length]
- The size of the constant string is larger than the size you specified in
- the array[x..y] of char definition
-\item [Error: Illegal expression after message directive]
- \fpc supports only integer or string values as message constants
-\item [Error: Message handlers can take only one call by ref. parameter]
- A method declared with the \var{message}-directive as message handler
- can take only one parameter which must be declared as call by reference
- 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 only be an explicit parameter in mehtods that are message handlers]
- The self parameter can only be passed explicitly to 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 mode switch 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
-\item [Error: Data types which requires initialization/finalization can't be used in variant records]
- Some data type (e.g. \var{ansistring}) needs initialization/finalization
- code which is implicitly generated by the compiler. Such data types
- can't be used in the variant part of a record.
-\item [Error: Resourcestrings can be only static or global]
- Resourcestring can not be declared local, only global or using the static
- directive.
-\item [Error: Exit with argument can't be used here]
- an exit statement with an argument for the return value can't be used here, this
- can happen e.g. in \var{try..except} or \var{try..finally} blocks
-\item [Error: The type of the storage symbol must be boolean]
- If you specify a storage symbol in a property declaration, it must be of
- the type boolean
-\item [Error: This symbol isn't allowed as storage symbol]
- You can't use this type of symbol as storage specifier in property
- declaration. You can use only methods with the result type boolean,
- boolean class fields or boolean constants
-\item [Error: Only class which are compiled in \$M+ mode can be published]
- In the published section of a class can be only class as fields used which
- are compiled in \var{\{\$M+\}} or which are derived from such a class. Normally
- such a class should be derived from TPersitent
-\item [Error: Procedure directive expected]
- When declaring a procedure in a const block you used a ; after the
- procedure declaration after which a procedure directive must follow.
- Correct declarations are:
- \begin{verbatim}
- const
-   p : procedure;stdcall=nil;
-   p : procedure stdcall=nil;
- \end{verbatim}
-\item [Error: The value for a property index must be of an ordinal type]
- The value you use to index a property must be of an ordinal type, for
- example an integer or enumerated type.
-\item [Error: Procedure name to short to be exported]
- The length of the procedure/function name must be at least 2 characters
- long. This is because of a bug in dlltool which doesn't parse the .def
- file correct with a name of length 1.
-\item [Error: No DEFFILE entry can be generated for unit global vars]
-\item [Error: Compile without -WD option]
- You need to compile this file without the -WD switch on the
- commandline
-\item [Fatal: You need ObjFpc (-S2) or Delphi (-Sd) mode to compile this module]
- You need to use \var{\{\$mode objfpc\}} or \var{\{\$mode delphi\}} to compile this file.
- Or use the equivalent commandline switches -S2 or -Sd.
-\item [Error: Can't export with index under arg1]
- Exporting of functions or procedures with a specified index is not
- support on all targets. The only platforms currently supporting
- export with index are OS/2 and Win32.
-\item [Error: Exporting of variables is not supported under arg1]
- Exporting of variables is not support on all targets. The only platform
- currently supporting export of variables is Win32.
-\item [Error: Type "arg1" can't be used as array index type]
- Types like DWord or Int64 aren't allowed as array index type
-\item [Warning: Some fields coming before "arg1" weren't initialized]
- In Delphi mode, not all fields of a typed constant record have to be
- initialized, but the compiler warns you when it detects such situations.
-\item [Error: Some fields coming before "arg1" weren't initialized]
- In all syntax modes but Delphi mode, you can't leave some fields uninitialized
- in the middle of a typed constant record
-\item [Hint: Some fields coming after "arg1" weren't initialized]
- You can leave some fields at the end of a type constant record uninitialized
- (the compiler will initialize them to zero automatically), but then the
- compiler gives you a hint when it detects such situations.
-\item [Error: Self must be a normal (call-by-value) parameter]
- You can't declare self as a const or var parameter, it must always be
- a call-by-value parameter
-\item [Error: Typed constants of the type "procedure of object" can only be initialized with NIL]
- You can't assign the address of a method to a typed constant which has a
- 'procedure of object' type, because such a constant requires two addresses:
- that of the method (which is known at compile time) and that of the object or
- class instance it operates on (which can not be known at compile time).
- \end{description}
- \section{Type checking errors}
- This section lists all errors that can occur when type checking is
- performed.
- \begin{description}
-\item [Error: Type mismatch]
- This can happen in many cases:
- \begin{itemize}
- \item The variable you're assigning to is of a different type than the
- expression in the assignment.
- \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.
- \end{verbatim}
-\item [Error: Type mismatch between arg1 and arg2]
- The types are not equal
-\item [Error: Type identifier expected]
- 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}
- procedure. You can only pass variables as arguments to these functions.
-\item [Error: Integer expression expected, but got "arg1"]
- The compiler expects an expression of type integer, but gets a different
- type.
-\item [Error: Boolean expression expected, but got "arg1"]
- The expression must be a boolean type, it should be return true or
- false.
-\item [Error: Ordinal expression expected]
- The expression must be of ordinal type, i.e., maximum a \var{Longint}.
- This happens, for instance, when you specify a second argument
- to \var{Inc} or \var{Dec} that doesn't evaluate to an ordinal value.
-\item [Error: pointer type expected, but got "arg1"]
- 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}
- or \var{Dispose}.
-\item [Error: class type expected, but got "arg1"]
- The variable of expression isn't of the type \var{class}. This happens
- typically when
- \begin{enumerate}
- \item The parent class in a class declaration isn't a class.
- \item An exception handler (\var{On}) contains a type identifier that
- isn't a class.
- \end{enumerate}
-\item [Error: Variable or type indentifier expected]
- The argument to the \var{High} or \var{Low} function is not a variable
- nor a type identifier.
-\item [Error: Can't evaluate constant expression]
- No longer in use.
-\item [Error: Set elements are not compatible]
- You are trying to make an operation on two sets, when the set element types
- are not the same. The base type of a set must be the same when taking the
- union
-\item [Error: Operation not implemented for sets]
- several binary operations are not defined for sets
- like div mod ** (also >= <= for now)
-\item [Warning: Automatic type conversion from floating type to COMP which is an integer type]
- An implicit type conversion from a real type to a \var{comp} is
- encountered. Since \var{Comp} is a 64 bit integer type, this may indicate
- an error.
-\item [Hint: use DIV instead to get an integer result]
- When hints are on, then an integer division with the '/' operator will
- procuce this message, because the result will then be of type real
-\item [Error: string types doesn't match, because of \$V+ mode]
- When compiling in \var{\{\$V+\}} mode, the string you pass as a parameter
- should be of the exact same type as the declared parameter of the procedure.
-\item [Error: succ or pred on enums with assignments not possible]
- When you declared an enumeration type which has assignments in it, as in C,
- like in the following:
- \begin{verbatim}
-   Tenum = (a,b,e:=5);
- \end{verbatim}
- you cannot use the \var{Succ} or \var{Pred} functions on them.
-\item [Error: Can't read or write variables of this type]
- You are trying to \var{read} or \var{write} a variable from or to a
- file of type text, which doesn't support that. Only integer types,
- booleans, reals, pchars and strings can be read from/written to a text file.
-\item [Error: Can't use readln or writeln on typed file]
- \var{readln} and \var{writeln} are only allowed for text files.
-\item [Error: Can't use read or write on untyped file.]
- \var{read} and \var{write} are only allowed for text or typed files.
-\item [Error: Type conflict between set elements]
- There is at least one set element which is of the wrong type, i.e. not of
- the set type.
-\item [Warning: lo/hi(dword/qword) returns the upper/lower word/dword]
- \fpc supports an overloaded version of \var{lo/hi} for \var{longint/dword/int64/qword}
- which returns the lower/upper word/dword of the argument. TP always uses
- a 16 bit \var{lo/hi} which returns always bits 0..7 for \var{lo} and the
- bits 8..15 for \var{hi}. If you want the TP behavior you have
- to type cast the argument to \var{word/integer}
-\item [Error: Integer or real expression expected]
- The first argument to \var{str} must a real or integer type.
-\item [Error: Wrong type arg1 in array constructor]
- You are trying to use a type in an array constructor which is not
- allowed.
-\item [Error: Incompatible type for arg no. 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.
-\item [Error: 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.
-\item [Error: Can't get the address of constants]
- It's not possible to get the address of a constant, because they
- aren't stored in memory, you can try making it a typed constant.
-\item [Error: Argument can't be assigned to]
- Only expressions which can be on the left side of an
- assignment can be passed as call by reference argument
- Remark: Properties can be only
- used on the left side of an assignment, but they can't be used as arguments
-\item [Error: Can't assign local procedure/function to procedure variable]
- It's not allowed to assign a local procedure/function to a
- procedure variable, because the calling of local procedure/function is
- different. You can only assign local procedure/function to a void pointer.
-\item [Error: Can't assign values to an address]
- It's not allowed to assign a value to an address of a variable, constant,
- procedure or function. You can try compiling with -So if the identifier
- is a procedure variable.
-\item [Error: Can't assign values to const variable]
- It's not allowed to assign a value to a variable which is declared
- as a const. This is normally a parameter declared as const, to allow
- changing make the parameter value or var.
-\item [Error: Array type required]
- If you are accessing a variable using an index '[<x>]' then
- the type must be an array. In FPC mode also a pointer is allowed.
-\item [Warning: Mixing signed expressions and cardinals gives a 64bit result]
- If you divide (or calculate the modulus of) a signed expression by a cardinal (or vice versa),
- or if you have overflow and/or range checking turned on and use an arithmetical
- expression (+, -, *, div, mod) in which both signed numbers and cardinals appear,
- then everything has to be evaluated in 64bit which is slower than normal
- 32bit arithmetics. You can avoid this by typecasting one operand so it
- matches the resulttype of the other one.
-\item [Warning: Mixing signed expressions and cardinals here may cause a range check error]
- If you use a binary operator (and, or, xor) and one of
- the operands is a cardinal while the other one is a signed expression, then,
- if range checking is turned on, you may get a range check error because in
- such a case both operands are converted to cardinal before the operation is
- carried out. You can avoid this by typecasting one operand so it
- matches the resulttype of the other one.
-\item [Error: Typecast has different size (arg1 -> arg2) in assignment]
- Type casting to a type with a different size is not allowed when the variable is
- used for assigning.
- \end{description}
- \section{Symbol handling}
- This section lists all the messages that concern the handling of symbols.
- This means all things that have to do with procedure and variable names.
- \begin{description}
-\item [Error: Identifier not found arg1]
- The compiler doesn't know this symbol. Usually happens when you misspel
- the name of a variable or procedure, or when you forgot to declare a
- variable.
-\item [Fatal: Internal Error in SymTableStack()]
- An internal error occurred in the compiler; If you encounter such an error,
- please contact the developers and try to provide  an exact description of
- 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.
-\item [Error: Forward declaration not solved arg1]
- This can happen in two cases:
- \begin{itemize}
- \item This happens when you declare a function (in the \var{interface} part, or
- with a \var{forward} directive, but do not implement it.
- \item You reference a type which isn't declared in the current \var{type}
- block.
- \end{itemize}
-\item [Fatal: Identifier type already defined as type]
- You are trying to redefine a type.
-\item [Error: Error in type definition]
- There is an error in your definition of a new array type:
- \item One of the range delimiters in an array declaration is erroneous.
- For example, \var{Array [1..1.25]} will trigger this error.
-\item [Error: Type identifier not defined]
- The type identifier has not been defined yet.
-\item [Error: Forward type not resolved arg1]
- A symbol was forward defined, but no declaration was encountered.
-\item [Error: Only static variables can be used in static methods or outside methods]
- A static method of an object can only access static variables.
-\item [Error: Invalid call to tvarsym.mangledname()]
- An internal error occurred in the compiler; If you encounter such an error,
- please contact the developers and try to provide  an exact description of
- 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 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: Label used but not defined arg1]
- A label was declared and used, but not defined.
-\item [Error: Illegal label declaration]
- This error should never happen; it occurs if a label is defined outside a
- procedure or function.
-\item [Error: GOTO and 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.
-\item [Error: Label not found]
- A \var{goto label} was encountered, but the label isn't declared.
-\item [Error: identifier isn't a label]
- The identifier specified after the \var{goto} isn't of type label.
-\item [Error: label already defined]
- You are defining a label twice. You can define a label only once.
-\item [Error: illegal type declaration of set elements]
- The declaration of a set contains an invalid type definition.
-\item [Error: Forward class definition not resolved arg1]
- You declared a class, but you didn't implement it.
-\item [Hint: Unit arg1 not used in arg2]
- The unit referenced in the \var{uses} clause is not used.
-\item [Hint: Parameter arg1 not used]
- This is a warning. The identifier was declared (locally or globally) but
- wasn't used (locally or globally).
-\item [Note: Local variable arg1 not used]
- You have declared, but not used a variable in a procedure or function
- implementation.
-\item [Hint: Value parameter arg1 is assigned but never used]
- This is a warning. The identifier was declared (locally or globally)
- set but not used (locally or globally).
-\item [Note: Local variable arg1 is assigned but never used]
- The variable in a procedure or function
- implementation is declared, set but never used.
-\item [Hint: Local arg1 arg2 is not used]
- A local symbol is never used.
-\item [Note: Private field arg1.arg2 is never used]
-\item [Note: Private field arg1.arg2 is assigned but never used]
-\item [Note: Private method arg1.arg2 never used]
-\item [Error: Set type expected]
- The variable or expression isn't of type \var{set}. This happens in an
- \var{in} statement.
-\item [Warning: Function result does not seem to be set]
- You can get this warning if the compiler thinks that a function return
- value is not set. This will not be displayed for assembler procedures,
- or procedures that contain assembler blocks.
-\item [Warning: Type arg1 is not aligned correctly in current record for C]
- Arrays with sizes not multiples of 4 will be wrongly aligned
- for C structures.
-\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]
-\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 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
- method of the class you are trying to create. The procedure you specified
- does not exist.
-\item [Found declaration: arg1]
- You get this when you use the \var{-vb} switch. In case an overloaded
- procedure is not found, then all candidate overloaded procedures are
- listed, with their parameter lists.
-\item [Error: Data segment too large (max. 2GB)]
- You get this when you declare an array whose size exceeds the 2GB limit.
- \end{description}
- \section{Code generator messages}
- This section lists all messages that can be displayed if the code
- generator encounters an error condition.
- \begin{description}
-\item [Error: BREAK not allowed]
- You're trying to use \var{break} outside a loop construction.
-\item [Error: CONTINUE not allowed]
- You're trying to use \var{continue} outside a loop construction.
-\item [Error: Expression too complicated - FPU stack overflow]
- Your expression is too long for the compiler. You should try dividing the
- construct over multiple assignments.
-\item [Error: Illegal expression]
- This can occur under many circumstances. Mostly when trying to evaluate
- constant expressions.
-\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 :
- \begin{itemize}
- \item You're trying to access a field of a variable that is not a record.
- \item You're indexing a variable that is not an array.
- \item You're dereferencing a variable that is not a pointer.
- \end{itemize}
-\item [Error: High range limit < low range limit]
- You are declaring a subrange, and the lower limit is higher than the high
- limit of the range.
-\item [Error: Illegal counter variable]
- The type of a \var{for} loop variable must be an ordinal type.
- Loop variables cannot be reals or strings.
-\item [Error: Can't determine which overloaded function to call]
- You're calling overloaded functions with a parameter that doesn't correspond
- to any of the declared function parameter lists. e.g. when you have declared
- a function with parameters \var{word} and \var{longint}, and then you call
- it with a parameter which is of type \var{integer}.
-\item [Error: Parameter list size exceeds 65535 bytes]
- The I386 processor limits the parameter list to 65535 bytes (the \var{RET}
- instruction causes this)
-\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.
-\item [Error: The use of a far pointer isn't allowed there]
- Free Pascal doesn't support far pointers, so you cannot take the address of
- an expression which has a far reference as a result. The \var{mem} construct
- has a far reference as a result, so the following code will produce this
- error:
- \begin{verbatim}
- var p : pointer;
- ...
- p:=@mem[a000:000];
- \end{verbatim}
-\item [Error: illegal call by reference parameters]
- You are trying to pass a constant or an expression to a procedure that
- requires a \var{var} parameter. Only variables can be passed as a \var{var}
- parameter.
-\item [Error: EXPORT declared functions can't be called]
- No longer in use.
-\item [Warning: Possible illegal call of constructor or destructor (doesn't match to this context)]
- No longer in use.
-\item [Note: Inefficient code]
- You construction seems dubious to the compiler.
-\item [Warning: unreachable code]
- You specified a loop which will never be executed. Example:
- \begin{verbatim}
- while false do
-   begin
-   {.. code ...}
-   end;
- \end{verbatim}
-\item [Error: procedure call with stackframe ESP/SP]
- 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]
- You cannot call an abstract method directy, instead you must call a
- overriding child method, because an abstract method isn't implemented.
-\item [Fatal: Internal Error in getfloatreg(), allocation failure]
- An internal error occurred in the compiler; If you encounter such an error,
- please contact the developers and try to provide  an exact description of
- the circumstances in which the error occurs.
-\item [Fatal: Unknown float type]
- The compiler cannot determine the kind of float that occurs in an expression.
-\item [Fatal: SecondVecn() base defined twice]
- An internal error occurred in the compiler; If you encounter such an error,
- please contact the developers and try to provide  an exact description of
- the circumstances in which the error occurs.
-\item [Fatal: Extended cg68k not supported]
- The \var{extended} type is not supported on the m68k platform.
-\item [Fatal: 32-bit unsigned not supported in MC68000 mode]
- The cardinal is not supported on the m68k platform.
-\item [Fatal: Internal Error in secondinline()]
- An internal error occurred in the compiler; If you encounter such an error,
- please contact the developers and try to provide  an exact description of
- the circumstances in which the error occurs.
-\item [Register arg1 weight arg2 arg3]
- Debugging message. Shown when the compiler considers a variable for
- keeping in the registers.
-\item [Error: Stack limit excedeed in local routine]
- 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 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: Object or class methods can't be inline.]
- You cannot have inlined object methods.
-\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: Direct call of interrupt procedure arg1 is not possible]
- You can not call an interrupt procedure directly from FPC code
-\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 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 [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
-\item [Error: Jump in or outside of an exception block]
- It isn't allowed to jump in or outside of an exception block like \var{try..finally..end;}:
- \begin{verbatim}
- label 1;
-
- ...
-
- try
-    if not(final) then
-      goto 1;   // this line will cause an error
- finally
-   ...
- end;
- 1:
- ...
- \end{verbatim}
-\item [Error: Control flow statements aren't allowed in a finally block]
- It isn't allowed to use the control flow statements \var{break},
- \var{continue} and \var{exit}
- inside a finally statement. The following example shows the problem:
- \begin{verbatim}
- ...
-   try
-      p;
-   finally
-      ...
-      exit;  // This exit ISN'T allowed
-   end;
- ...
-
- \end{verbatim}
- If the procedure \var{p} raises an exception the finally block is
- executed. If the execution reaches the exit, it's unclear what to do:
- exiting the procedure or searching for another exception handler
- \end{description}
-
- \section{Errors of assembling/linking stage}
- This section lists errors that occur when the compiler is processing the
- command line or handling the configuration files.
- \begin{description}
-\item [Warning: Source operating system redefined]
-\item [Info: Assembling (pipe) arg1]
-\item [Error: Can't create assember file: arg1]
- The mentioned file can't be create. Check if you've
- permission to create this file
-\item [Error: Can't create object file: arg1]
- The mentioned file can't be create. Check if you've
- permission to create this file
-\item [Error: Can't create archive file: arg1]
- The mentioned file can't be create. Check if you've
- permission to create this file
-\item [Error: Assembler arg1 not found, switching to external assembling]
-\item [Using assembler: arg1]
-\item [Error: Error while assembling exitcode arg1]
-\item [Error: Can't call the assembler, error arg1 switching to external assembling]
-\item [Info: Assembling arg1]
-\item [Info: Assembling smartlink arg1]
-\item [Warning: Object arg1 not found, Linking may fail !]
-\item [Warning: Library arg1 not found, Linking may fail !]
-\item [Error: Error while linking]
-\item [Error: Can't call the linker, switching to external linking]
-\item [Info: Linking arg1]
-\item [Error: Util arg1 not found, switching to external linking]
-\item [Using util arg1]
-\item [Error: Creation of Executables not supported]
-\item [Error: Creation of Dynamic/Shared Libraries not supported]
-\item [Info: Closing script arg1]
-\item [Error: resource compiler not found, switching to external mode]
-\item [Info: Compiling resource arg1]
-\item [unit arg1 can't be static linked, switching to smart linking]
-\item [unit arg1 can't be smart linked, switching to static linking]
-\item [unit arg1 can't be shared linked, switching to static linking]
-\item [Error: unit arg1 can't be smart or static linked]
-\item [Error: unit arg1 can't be shared or static linked]
-\end{description}
- \section{Unit loading messages.}
- This section lists all messages that can occur when the compiler is
- loading a unit from disk into memory. Many of these mesages are
- informational messages.
- \begin{description}
-\item [Unitsearch: arg1]
- When you use the \var{-vt}, the compiler tells you where it tries to find
- unit files.
-\item [PPU Loading arg1]
- When the \var{-vt} switch is used, the compiler tells you
- what units it loads.
-\item [PPU Name: arg1]
- When you use the \var{-vu} flag, the unit name is shown.
-\item [PPU Flags: arg1]
- When you use the \var{-vu} flag, the unit flags are shown.
-\item [PPU Crc: arg1]
- When you use the \var{-vu} flag, the unit CRC check is shown.
-\item [PPU Time: arg1]
- When you use the \var{-vu} flag, the time the unit was compiled is shown.
-\item [PPU File too short]
- The ppufile is too short, not all declarations are present.
-\item [PPU Invalid Header (no PPU at the begin)]
- A unit file contains as the first three bytes the ascii codes of \var{PPU}
-\item [PPU Invalid Version arg1]
- This unit file was compiled with a different version of the compiler, and
- cannot be read.
-\item [PPU is compiled for an other processor]
- This unit file was compiled for a different processor type, and
- cannot be read
-\item [PPU is compiled for an other target]
- This unit file was compiled for a different target, and
- cannot be read
-\item [PPU Source: arg1]
- When you use the \var{-vu} flag, the unit CRC check is shown.
-\item [Writing arg1]
- When you specify the \var{-vu} switch, the compiler will tell you where it
- writes the unit file.
-\item [Fatal: Can't Write PPU-File]
- An error occurred when writing the unit file.
-\item [Fatal: Error reading PPU-File]
- This means that the unit file was corrupted, and contains invalid
- information. Recompilation will be necessary.
-\item [Fatal: unexpected end of PPU-File]
- Unexpected end of file.
-\item [Fatal: Invalid PPU-File entry: arg1]
- The unit the compiler is trying to read is corrupted, or generated with a
- newer version of the compiler.
-\item [Fatal: PPU Dbx count problem]
- There is an inconsistency in the debugging information of the unit.
-\item [Error: Illegal unit name: arg1]
- The name of the unit doesn't match the file name.
-\item [Fatal: Too much units]
- \fpc has a limit of 1024 units in a program. You can change this behavior
- by changing the \var{maxunits} constant in the \file{files.pas} file of the
- compiler, and recompiling the compiler.
-\item [Fatal: Circular unit reference between arg1 and arg2]
- Two units are using each other in the interface part. This is only allowed
- in the \var{implementation} part. At least one unit must contain the other one
- in the \var{implementation} section.
-\item [Fatal: Can't compile unit arg1, no sources available]
- A unit was found that needs to be recompiled, but no sources are
- available.
-\item [Warning: Can't recompile unit arg1, but found modifed include files]
- A unit was found to have modified include files, but
- some source files were not found, so recompilation is impossible.
-\item [Fatal: Can't find unit arg1]
- You tried to use a unit of which the PPU file isn't found by the
- compiler. Check your config files for the unit pathes
-\item [Warning: Unit arg1 was not found but arg2 exists]
-\item [Fatal: Unit arg1 searched but arg2 found]
- Dos truncation of 8 letters for unit PPU files
- may lead to problems when unit name is longer than 8 letters.
-\item [Warning: Compiling the system unit requires the -Us switch]
- When recompiling the system unit (it needs special treatment), the
- \var{-Us} must be specified.
-\item [Fatal: There were arg1 errors compiling module, stopping]
- When the compiler encounters a fatal error or too many errors in a module
- then it stops with this message.
-\item [Load from arg1 (arg2) unit arg3]
- When you use the \var{-vu} flag, which unit is loaded from which unit is
- shown.
-\item [Recompiling arg1, checksum changed for arg2]
-\item [Recompiling arg1, source found only]
- When you use the \var{-vu} flag, these messages tell you why the current
- unit is recompiled.
-\item [Recompiling unit, static lib is older than ppufile]
- When you use the \var{-vu} flag, the compiler warns if the static library
- of the unit are older than the unit file itself.
-\item [Recompiling unit, shared lib is older than ppufile]
- When you use the \var{-vu} flag, the compiler warns if the shared library
- of the unit are older than the unit file itself.
-\item [Recompiling unit, obj and asm are older than ppufile]
- When you use the \var{-vu} flag, the compiler warns if the assembler or
- object file of the unit are older than the unit file itself.
-\item [Recompiling unit, obj is older than asm]
- When you use the \var{-vu} flag, the compiler warns if the assembler
- file of the unit is older than the object file of the unit.
-\item [Parsing interface of arg1]
- When you use the \var{-vu} flag, the compiler warns that it starts
- parsing the interface part of the unit
-\item [Parsing implementation of arg1]
- When you use the \var{-vu} flag, the compiler warns that it starts
- parsing the implementation part of the unit
-\item [Second load for unit arg1]
- When you use the \var{-vu} flag, the compiler warns that it starts
- recompiling a unit for the second time. This can happend with interdepend
- units.
-\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
-\item [Hint: Conditional arg1 was not set at startup in last compilation of arg2]
- when recompilation of an unit is required the compiler will check that
- the same conditionals are set for the recompiliation. The compiler has
- found a conditional that currently is defined, but was not used the last
- time the unit was compiled.
-\item [Hint: Conditional arg1 was set at startup in last compilation of arg2]
- when recompilation of an unit is required the compiler will check that
- the same conditionals are set for the recompiliation. The compiler has
- found a conditional that was used the last time the unit was compiled, but
- the conditional is currently not defined.
-\item [Hint: File arg1 is newer than Release PPU file arg2]
- \end{description}
-
- \section{Command-line handling errors}
- This section lists errors that occur when the compiler is processing the
- command line or handling the configuration files.
- \begin{description}
-\item [Warning: Only one source file supported]
- You can specify only one source file on the command line. The first
- one will be compiled, others will be ignored. This may indicate that
- you forgot a \var{'-'} sign.
-\item [Warning: DEF file can be created only for OS/2]
- This option can only be specified when you're compiling for OS/2
-\item [Error: nested response files are not supported]
- you cannot nest response files with the \var{@file} command-line option.
-\item [Fatal: No source file name in command line]
- The compiler expects a source file name on the command line.
-\item [Note: No option inside arg1 config file]
- The compiler didn't find any option in that config file.
-\item [Error: Illegal parameter: arg1]
- You specified an unknown option.
-\item [Hint: -? writes help pages]
- When an unknown option is given, this message is diplayed.
-\item [Fatal: Too many config files nested]
- You can only nest up to 16 config files.
-\item [Fatal: Unable to open file arg1]
- The option file cannot be found.
-\item [Reading further options from arg1]
- Displayed when you have notes turned on, and the compiler switches
- to another options file.
-\item [Warning: Target is already set to: arg1]
- Displayed if more than one \var{-T} option is specified.
-\item [Warning: Shared libs not supported on DOS platform, reverting to static]
- If you specify \var{-CD} for the \dos platform, this message is displayed.
- The compiler supports only static libraries under \dos
-\item [Fatal: too many IF(N)DEFs]
- the \var{\#IF(N)DEF} statements in the options file are not balanced with
- the \var{\#ENDIF} statements.
-\item [Fatal: too many ENDIFs]
- the \var{\#IF(N)DEF} statements in the options file are not balanced with
- the \var{\#ENDIF} statements.
-\item [Fatal: open conditional at the end of the file]
- the \var{\#IF(N)DEF} statements in the options file are not balanced with
- the \var{\#ENDIF} statements.
-\item [Warning: Debug information generation is not supported by this executable]
- 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 [Hint: Try recompiling with -dGDB]
- 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 [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.
-\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.
-\item [Warning: Assembler output selected "arg1" is not compatible with "arg2"]
-\item [Warning: "arg1" assembler use forced]
- The assembler output selected can not generate
- object files with the correct format. Therefore, the
- default assembler for this target is used instead.
-\item [*** press enter ***]
-\end{description}

+ 1 - 1
docs/user.tex

@@ -3266,7 +3266,7 @@ messages is generated from he compiler source itself, and should be faitly
 complete. At this point, only assembler errors are not in the list.
 
 % Message file is generated with msg2inc.
-\input {messages.tex}
+\input {messages.inc}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Assembler reader errors

Some files were not shown because too many files changed in this diff