1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2011, Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 with Osint; use Osint;
27 with Output; use Output;
28 with Switch; use Switch;
30 with System.WCh_Con; use System.WCh_Con;
32 package body Bindusg is
34 Already_Displayed : Boolean := False;
35 -- Set True if Display called, used to avoid showing usage information
44 if Already_Displayed then
47 Already_Displayed := True;
52 Write_Str ("Usage: ");
55 Write_Str ("switches lfile");
59 Display_Usage_Version_And_Help;
61 -- Line for @response_file
63 Write_Line (" @<resp_file> Get arguments from response file");
66 -- Line for -aO switch
68 Write_Line (" -aOdir Specify library files search path");
70 -- Line for -aI switch
72 Write_Line (" -aIdir Specify source files search path");
76 Write_Line (" -a Automatically initialize elaboration " &
81 Write_Line (" -A Give list of ALI files in partition");
85 Write_Line (" -b Generate brief messages to stderr " &
86 "even if verbose mode set");
90 Write_Line (" -c Check only, no generation of " &
91 "binder output file");
95 Write_Line (" -dnn[k|m] Default primary stack " &
96 "size = nn [kilo|mega] bytes");
100 Write_Line (" -Dnn[k|m] Default secondary stack " &
101 "size = nn [kilo|mega] bytes");
103 -- Line for -e switch
105 Write_Line (" -e Output complete list of elaboration " &
106 "order dependencies");
108 -- Line for -E switch
110 Write_Line (" -E Store tracebacks in exception occurrences");
112 -- The -f switch is voluntarily omitted, because it is obsolete
114 -- Line for -F switch
116 Write_Line (" -F Force checking of elaboration Flags");
118 -- Line for -h switch
120 Write_Line (" -h Output this usage (help) information");
122 -- Line for -H switch
124 Write_Line (" -Hnn Use nn bit heap where nn is 32 or 64 " &
127 -- Lines for -I switch
129 Write_Line (" -Idir Specify library and source files search path");
130 Write_Line (" -I- Don't look for sources & library files " &
131 "in default directory");
133 -- Line for -K switch
135 Write_Line (" -K Give list of linker options specified " &
138 -- Line for -l switch
140 Write_Line (" -l Output chosen elaboration order");
144 Write_Line (" -Lxyz Library build: adainit/final " &
145 "renamed to xyzinit/final, implies -n");
147 -- Line for -m switch
149 Write_Line (" -mnnn Limit number of detected errors/warnings " &
150 "to nnn (1-999999)");
152 -- Line for -M switch
154 Write_Line (" -Mxyz Rename generated main program from " &
157 -- Line for -n switch
159 Write_Line (" -n No Ada main program (foreign main routine)");
161 -- Line for -nostdinc
163 Write_Line (" -nostdinc Don't look for source files " &
164 "in the system default directory");
166 -- Line for -nostdlib
168 Write_Line (" -nostdlib Don't look for library files " &
169 "in the system default directory");
171 -- Line for -o switch
173 Write_Line (" -o file Give the output file name " &
174 "(default is b~xxx.adb)");
176 -- Line for -O switch
178 Write_Line (" -O Give list of objects required for link");
180 -- Line for -p switch
182 Write_Line (" -p Pessimistic (worst-case) elaboration order");
184 -- Line for -P switch
186 Write_Line (" -P Generate binder file suitable for CodePeer");
188 -- Line for -r switch
190 Write_Line (" -r List restrictions that could be applied " &
191 "to this partition");
193 -- Line for -R switch
196 (" -R List sources referenced in closure");
198 -- Line for -s switch
200 Write_Line (" -s Require all source files to be present");
202 -- Line for -S?? switch
204 Write_Line (" -S?? Sin/lo/hi/xx/ev Initialize_Scalars " &
205 "invalid/low/high/hex/env var");
209 Write_Line (" -static Link against a static GNAT run time");
213 Write_Line (" -shared Link against a shared GNAT run time");
215 -- Line for -t switch
217 Write_Line (" -t Tolerate time stamp and other " &
218 "consistency errors");
220 -- Line for -T switch
222 Write_Line (" -Tn Set time slice value to n " &
223 "milliseconds (n >= 0)");
225 -- Line for -u switch
227 Write_Line (" -un Enable dynamic stack analysis, with " &
230 -- Line for -v switch
232 Write_Line (" -v Verbose mode. Error messages, " &
233 "header, summary output to stdout");
235 -- Line for -w switch
237 Write_Line (" -wx Warning mode. (x=s/e for " &
238 "suppress/treat as error)");
240 -- Line for -W switch
242 Write_Str (" -W? Wide character encoding method (");
244 for J in WC_Encoding_Method loop
245 Write_Char (WC_Encoding_Letters (J));
247 if J = WC_Encoding_Method'Last then
256 -- Line for -x switch
258 Write_Line (" -x Exclude source files (check object " &
259 "consistency only)");
261 -- Line for -X switch
263 Write_Line (" -Xnnn Default exit status value = nnn");
265 -- Line for -y switch
267 Write_Line (" -y Enable leap seconds");
269 -- Line for -z switch
271 Write_Line (" -z No main subprogram (zero main)");
275 -- Line for -Z switch
278 "Zero formatting in auxiliary outputs (-e, -K, -l, -R)");
282 Write_Line (" --RTS=dir Specify the default source and " &
283 "object search path");
287 Write_Line (" lfile Library file names");