From 541cbaa20bc7c11c609f186d53070193a1b902a2 Mon Sep 17 00:00:00 2001 From: michael Date: Tue, 22 Dec 1998 12:53:31 +0000 Subject: [PATCH] + Changed options description to fit version 0.99.10 --- docs/user.tex | 75 ++++++++++++++++++++++++++++++++------------------- 1 file changed, 48 insertions(+), 27 deletions(-) diff --git a/docs/user.tex b/docs/user.tex index c37eb7362b..8fc624d886 100644 --- a/docs/user.tex +++ b/docs/user.tex @@ -830,7 +830,8 @@ isn't under \dos. % Using the command-line options \section{Using the command-line options} -The available options are listed by category: +The available options for version 0.99.10 of the compiler are listed by +category (see appendix A for a listing as generated by the compiler): % % General options @@ -843,7 +844,16 @@ and exits after that. \olabel{h} \item[-?] idem as \var{-h}, waiting after every screenfull for the enter key. \item[-i] This option tells the compiler to print the copyright information. -\olabel{i} +\olabel{i} You can give it an option, as \var{-ixxx} where xxx can be one of the +following: +\begin{description} +\item[D] : Returns the compiler date. +\item[V] : Returns the compiler version. +\item[SO] : Returns the compiler OS. +\item[SP] : Returns the compiler processor. +\item[TO] : Returns the target OS. +\item[TP] : Returns the target Processor. +\end{description} \item[-l] This option tells the compiler to print the \fpc logo on standard output. It also gives you the \fpc version number. \olabel{l} @@ -879,8 +889,12 @@ conditional. same as specifying all options) \item \var{0} : Tells the compiler to write no messages. This is useful when you want to override the default setting in the configuration file. -\item \var{b} Tells the compiler to show all procedure declarations if an +\item \var{b} : Tells the compiler to show all procedure declarations if an overloaded function error occurs. +\item \var{x} : Tells the compiler to output some executable info (for Win32 +platform only). +\item \var{r} : Rhide/GCC compatibility mode: formats the errors +differently, so they are understood by RHIDE. \end{itemize} \end{description} @@ -893,11 +907,12 @@ overloaded function error occurs. compiler can find the executables \file{as} (the assembler) and \file{ld} (the compiler). \olabel{e} +\item [-FD] same as \var{-e}. \item [-Fexxx] This option tells the compiler to write errors, etc. to the file in \file{xxx}. \olabel{Fe} -\item [-Fgxxx] (\linux only) \file{xxx} specifies the path where the compiler -can find the \gnu C library. +\item [-Fgxxx] (\linux only, obsolete) \file{xxx} specifies the path where the compiler +can find the \gnu C library. This is superseded by the \var{-Fl} option. \olabel{Fg} \item [-Fixxx] adds \var{xxx} to the path where the compiler searches for its include files. @@ -918,6 +933,8 @@ will override the default messages. \olabel{Fr} \item [-Fuxxx] Idem as \var{-Up}: Add \file{xxx} to the object path. \olabel{Fu} +\item [-FUxxx] Tells the compiler to write units in directory \var{xxx} +instead of the current directory. \item [-Ixxx] \olabel{I} Add \file{xxx} to the include file search path. This path is used when looking for include files. \item [-P] uses pipes instead of files when assembling. This may speed up @@ -967,7 +984,7 @@ to conditionally compile parts of your code. \file{gdb} \item [-gg] idem as \var{-g}. \item [-gd] \olabel{gd} generate debugging info for \file{dbx}. - +\item [-gh] use the heaptrc unit (see \unitsref). \item[-Oxxx] \olabel{O} optimize the compiler's output; \var{xxx} can have one of the following values : \begin{description} @@ -1005,8 +1022,6 @@ the following: \end{itemize} \item [-uxxx] \olabel{u} undefine the symbol \var{xxx}. This is the opposite of the \var{-d} option. -\item [-Uld] \olabel{Uld} make dynamic library from unit. -\item [-Uls] \olabel{Uls} make static library from unit. \item [-uxxx] \olabel{U} Undefine symbol \var{xxx}. \item [-Xx] \olabel{X} executable options. This tells the compiler what @@ -1059,9 +1074,6 @@ compatible. \item [-Ss] \olabel{Ss} The name of constructors must be \var{init}, and the name of destructors should be \var{done}. \item [-St] \olabel{St} Allow the \var{static} keyword in objects. -\item [-Sv] allow variable directives (cvar, external, public, export). -You cannot use the \var{cvar} or \var{external} modifiers on variables, -unless you use this switch. \item [-Un] \olabel{Un} Do not check the unit name. Normally, the unit name is the same as the filename. This option allows both to be different. \item [-Us] \olabel{Us} Compile a system unit. This option causes the @@ -2208,9 +2220,9 @@ The following is alphabetical listing of all command-line options, as generated by the compiler: \begin{verbatim} ppc386 [options] [options] -+ switch option on, - off +put + after a boolean switch option to enable it, - to disable it -a the compiler doesn't delete the generated assembler file - -al list sourcecode lines in assembler file (still BETA !!) + -al list sourcecode lines in assembler file -B build all modules -C code generation options -CD create dynamic library @@ -2227,7 +2239,9 @@ ppc386 [options] [options] -e set path to executable -E same as -Cn -F set file names and paths + -FD sets the directory where to search for compiler utilities -Fe redirect error output to + -FE set exe/unit output path to -Fg same as -Fl -Fi adds to include path -Fl adds to library path @@ -2235,10 +2249,18 @@ ppc386 [options] [options] -Fo adds to object path -Fr load error message file -Fu adds to unit path + -FU set unit output path to , overrides -FE -g generate debugger information -gg use gsym -gd use dbx + -gh use heap trace unit -i information + -iD return compiler date + -iV return compiler version + -iSO return source OS + -iSP return source processor + -iTO return target OS + -iTP return target processor -I adds to include path -k Pass to the linker -l write logo @@ -2249,7 +2271,7 @@ ppc386 [options] [options] -S syntax options -S2 switch some Delphi 2 extensions on -Sc supports operators like C (*=,+=,/= and -=) - -Sd compiler disposes asm lists (uses less memory but slower) + -Sd tries to be Delphi compatible -Se compiler stops after the first error -Sg allow LABEL and GOTO -Si support C++ stlyed INLINE @@ -2258,14 +2280,7 @@ ppc386 [options] [options] -Sp tries to be gpc compatible -Ss constructor name must be init (destructor must be done) -St allow static keyword in objects - -Sv allow variable directives (cvar,external,public,export) -s don't call assembler and linker (only with -a) - -T Target operating system - -TGO32V1 version 1 of DJ Delorie DOS extender - -TGO32V2 version 2 of DJ Delorie DOS extender - -TLINUX Linux - -TOS2 OS/2 2.x - -TWin32 Windows 32 Bit -u undefines the symbol -U unit options -Un don't check the unit name @@ -2273,14 +2288,14 @@ ppc386 [options] [options] -Us compile a system unit -v Be verbose. is a combination of the following letters : e : Show errors (default) d : Show debug info - w : Show warnings u : Show used files - n : Show notes t : Show tried files + w : Show warnings u : Show unit info + n : Show notes t : Show tried/used files h : Show hints m : Show defined macros i : Show general info p : Show compiled procedures l : Show linenumbers c : Show conditionals a : Show everything 0 : Show nothing (except errors) - b : Show all procedure - declarations if an error + b : Show all procedure r : Rhide/GCC compatibility mode + declarations if an error x : Executable info (Win32 only) occurs -X executable options -Xc link with the c library @@ -2289,14 +2304,14 @@ ppc386 [options] [options] -XS link with static libraries (defines FPC_LINK_STATIC) Processor specific options: - -A output format + -A output format -Ao coff file using GNU AS -Anasmcoff coff file using Nasm -Anasmelf elf32 (linux) file using Nasm -Anasmobj obj file using Nasm -Amasm obj using Masm (Mircosoft) -Atasm obj using Tasm (Borland) - -R assembler reading style + -R assembler reading style -Ratt read AT&T style assembler -Rintel read Intel style assembler -Rdirect copy assembler text directly to assembler file @@ -2312,6 +2327,12 @@ Processor specific options: -Op1 set target processor to 386/486 -Op2 set target processor to Pentium/PentiumMMX (tm) -Op3 set target processor to PPro/PII/c6x86/K6 (tm) + -T Target operating system + -TGO32V1 version 1 of DJ Delorie DOS extender + -TGO32V2 version 2 of DJ Delorie DOS extender + -TLINUX Linux + -TOS2 OS/2 2.x + -TWin32 Windows 32 Bit -? shows this help -h shows this help without waiting