1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2010, 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 ------------------------------------------------------------------------------
27 with Osint
; use Osint
;
28 with Output
; use Output
;
33 -- Start of processing for Makeusg
38 Write_Str
("Usage: ");
39 Osint
.Write_Program_Name
;
40 Write_Str
(" opts name ");
41 Write_Str
("{[-cargs opts] [-bargs opts] [-largs opts] [-margs opts]}");
44 Write_Str
(" name is one or more file name from which you");
45 Write_Str
(" can omit the .adb or .ads suffix");
51 Write_Str
("gnatmake switches:");
56 Write_Str
(" -a Consider all files, even readonly ali files");
61 Write_Str
(" -b Bind only");
66 Write_Str
(" -B Build, bind and link full project");
71 Write_Str
(" -c Compile only");
76 Write_Str
(" -C Cache source mappings: " &
77 "invoke compiler with temp mapping file");
80 -- Line for -C=<mapping file>
82 Write_Str
(" -C=mapp Cache source mappings: " &
83 "invoke compiler with mapping file mapp");
88 Write_Str
(" -D dir Specify dir as the object directory");
93 Write_Str
(" -eI Index of unit in multi-unit source file");
98 Write_Str
(" -eL Follow symbolic links when processing " &
104 Write_Str
(" -eS Echo commands to stdout instead of stderr");
109 Write_Str
(" -f Force recompilations of non predefined units");
114 Write_Str
(" -F Full project path name in brief error messages");
119 Write_Str
(" -i In place. Replace existing ali file, ");
120 Write_Str
("or put it with source");
125 Write_Str
(" -jnum Use nnn processes to compile");
130 Write_Str
(" -k Keep going after compilation errors");
135 Write_Str
(" -l Link only");
140 Write_Str
(" -m Minimal recompilation");
145 Write_Str
(" -M List object file dependences for Makefile");
150 Write_Str
(" -n Check objects up to date, output next file ");
151 Write_Str
("to compile if not");
156 Write_Str
(" -o name Choose an alternate executable name");
161 Write_Str
(" -p Create missing obj, lib and exec dirs");
166 Write_Str
(" -Pproj Use GNAT Project File proj");
171 Write_Str
(" -q Be quiet/terse");
176 Write_Str
(" -R Do not use a run_path_option when linking");
181 Write_Str
(" -s Recompile if compiler switches have changed");
186 Write_Str
(" -u Unique compilation, only compile the given files");
191 Write_Str
(" -U Unique compilation for all sources of all projects");
196 Write_Str
(" -v Display reasons for all (re)compilations");
201 Write_Str
(" -vl Verbose output (low verbosity)");
206 Write_Str
(" -vm Verbose output (medium verbosity)");
211 Write_Str
(" -vh Equivalent to -v (high verbosity)");
216 Write_Str
(" -vPx Specify verbosity when parsing GNAT Project Files");
221 Write_Str
(" -we Treat all warnings as errors");
226 Write_Str
(" -wn Normal warning mode (cancels -we/-ws)");
231 Write_Str
(" -ws Suppress all warnings");
237 "Allow compilation of needed units external to the projects");
242 Write_Str
(" -Xnm=val Specify an external reference for GNAT " &
248 Write_Str
(" -z No main subprogram (zero main)");
252 Write_Str
(" --GCC=command Use this gcc command");
255 Write_Str
(" --GNATBIND=command Use this gnatbind command");
258 Write_Str
(" --GNATLINK=command Use this gnatlink command");
262 -- Source and Library search path switches
264 Write_Str
("Project, Source and Library search path switches:");
269 Write_Str
(" -aPdir Add directory dir to project search path");
274 Write_Str
(" -aLdir Skip missing library sources if ali in dir");
279 Write_Str
(" -Adir like -aLdir -aIdir");
282 -- Line for -aO switch
284 Write_Str
(" -aOdir Specify library/object files search path");
287 -- Line for -aI switch
289 Write_Str
(" -aIdir Specify source files search path");
292 -- Line for -I switch
294 Write_Str
(" -Idir Like -aIdir -aOdir");
297 -- Line for -I- switch
299 Write_Str
(" -I- Don't look for sources & library files");
300 Write_Str
(" in the default directory");
305 Write_Str
(" -Ldir Look for program libraries also in dir");
308 -- Line for -nostdinc
310 Write_Str
(" -nostdinc Don't look for sources");
311 Write_Str
(" in the system default directory");
314 -- Line for -nostdlib
316 Write_Str
(" -nostdlib Don't look for library files");
317 Write_Str
(" in the system default directory");
322 Write_Str
(" --RTS=dir specify the default source and object search"
326 -- Line for --subdirs=
328 Write_Str
(" --subdirs=dir real obj/lib/exec dirs are subdirs");
331 -- Line for --source-info=
334 Write_Str
(Makeutl
.Source_Info_Option
);
335 Write_Str
("file specify a source info file");
338 -- Line for --unchecked-shared-lib-imports
341 Write_Str
(Makeutl
.Unchecked_Shared_Lib_Imports
);
343 Write_Str
(" Allow shared libraries to import static libraries");
347 -- General Compiler, Binder, Linker switches
349 Write_Str
("To pass an arbitrary switch to the Compiler, ");
350 Write_Str
("Binder or Linker:");
355 Write_Str
(" -cargs opts opts are passed to the compiler");
360 Write_Str
(" -bargs opts opts are passed to the binder");
365 Write_Str
(" -largs opts opts are passed to the linker");
370 Write_Str
(" -margs opts opts are passed to gnatmake");
373 -- Add usage information for gcc