1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2014, 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;
29 with Switch; use Switch;
34 -- Start of processing for Makeusg
39 Write_Str ("Usage: ");
40 Osint.Write_Program_Name;
41 Write_Str (" opts name ");
42 Write_Str ("{[-cargs opts] [-bargs opts] [-largs opts] [-margs opts]}");
45 Write_Str (" name is one or more file name from which you");
46 Write_Str (" can omit the .adb or .ads suffix");
52 Write_Str ("gnatmake switches:");
55 Display_Usage_Version_And_Help;
59 Write_Str (" -a Consider all files, even readonly ali files");
64 Write_Str (" -b Bind only");
69 Write_Str (" -B Build, bind and link full project");
74 Write_Str (" -c Compile only");
79 Write_Str (" -C Cache source mappings: " &
80 "invoke compiler with temp mapping file");
83 -- Line for -C=<mapping file>
85 Write_Str (" -C=mapp Cache source mappings: " &
86 "invoke compiler with mapping file mapp");
91 Write_Str (" -d Display compilation progress");
96 Write_Str (" -D dir Specify dir as the object directory");
101 Write_Str (" -eI Index of unit in multi-unit source file");
106 Write_Str (" -eL Follow symbolic links when processing " &
112 Write_Str (" -eS Echo commands to stdout instead of stderr");
117 Write_Str (" -f Force recompilations of non predefined units");
122 Write_Str (" -F Full project path name in brief error messages");
127 Write_Str (" -i In place. Replace existing ali file, ");
128 Write_Str ("or put it with source");
133 Write_Str (" -jnum Use nnn processes to compile");
138 Write_Str (" -k Keep going after compilation errors");
143 Write_Str (" -l Link only");
148 Write_Str (" -m Minimal recompilation");
153 Write_Str (" -M List object file dependences for Makefile");
158 Write_Str (" -n Check objects up to date, output next file ");
159 Write_Str ("to compile if not");
164 Write_Str (" -o name Choose an alternate executable name");
169 Write_Str (" -p Create missing obj, lib and exec dirs");
174 Write_Str (" -Pproj Use GNAT Project File proj");
179 Write_Str (" -q Be quiet/terse");
184 Write_Str (" -R Do not use a run_path_option when linking");
189 Write_Str (" -s Recompile if compiler switches have changed");
194 Write_Str (" -u Unique compilation, only compile the given files");
199 Write_Str (" -U Unique compilation for all sources of all projects");
204 Write_Str (" -v Display reasons for all (re)compilations");
209 Write_Str (" -vl Verbose output (low verbosity)");
214 Write_Str (" -vm Verbose output (medium verbosity)");
219 Write_Str (" -vh Equivalent to -v (high verbosity)");
224 Write_Str (" -vPx Specify verbosity when parsing GNAT Project Files");
229 Write_Str (" -we Treat all warnings as errors");
234 Write_Str (" -wn Normal warning mode (cancels -we/-ws)");
239 Write_Str (" -ws Suppress all warnings");
245 "Allow compilation of needed units external to the projects");
250 Write_Str (" -Xnm=val Specify an external reference for GNAT " &
256 Write_Str (" -z No main subprogram (zero main)");
260 Write_Str (" --create-map-file Create map file mainprog.map");
263 Write_Str (" --create-map-file=mapfile");
265 Write_Str (" Create map file mapfile");
268 Write_Str (" --keep-temp-files Keep temporary files");
271 Write_Str (" --GCC=command Use this gcc command");
274 Write_Str (" --GNATBIND=command Use this gnatbind command");
277 Write_Str (" --GNATLINK=command Use this gnatlink command");
281 -- Source and Library search path switches
283 Write_Str ("Project, Source and Library search path switches:");
288 Write_Str (" -aPdir Add directory dir to project search path");
293 Write_Str (" -aLdir Skip missing library sources if ali in dir");
298 Write_Str (" -Adir like -aLdir -aIdir");
301 -- Line for -aO switch
303 Write_Str (" -aOdir Specify library/object files search path");
306 -- Line for -aI switch
308 Write_Str (" -aIdir Specify source files search path");
311 -- Line for -I switch
313 Write_Str (" -Idir Like -aIdir -aOdir");
316 -- Line for -I- switch
318 Write_Str (" -I- Don't look for sources & library files");
319 Write_Str (" in the default directory");
324 Write_Str (" -Ldir Look for program libraries also in dir");
327 -- Line for -nostdinc
329 Write_Str (" -nostdinc Don't look for sources");
330 Write_Str (" in the system default directory");
333 -- Line for -nostdlib
335 Write_Str (" -nostdlib Don't look for library files");
336 Write_Str (" in the system default directory");
341 Write_Str (" --RTS=dir specify the default source and object search"
345 -- Line for --subdirs=
347 Write_Str (" --subdirs=dir real obj/lib/exec dirs are subdirs");
350 -- Line for --source-info=
353 Write_Str (Makeutl.Source_Info_Option);
354 Write_Str ("file specify a source info file");
357 -- Line for --unchecked-shared-lib-imports
360 Write_Str (Makeutl.Unchecked_Shared_Lib_Imports);
362 Write_Str (" Allow shared libraries to import static libraries");
366 -- General Compiler, Binder, Linker switches
368 Write_Str ("To pass an arbitrary switch to the Compiler, ");
369 Write_Str ("Binder or Linker:");
374 Write_Str (" -cargs opts opts are passed to the compiler");
379 Write_Str (" -bargs opts opts are passed to the binder");
384 Write_Str (" -largs opts opts are passed to the linker");
389 Write_Str (" -margs opts opts are passed to gnatmake");
392 -- Add usage information for gcc