gcc/ada/bindusg.adb

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                             B I N D U S G                                --
   6 --                                                                          --
   7 --                                B o d y                                   --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2007, Free Software Foundation, Inc.         --
  10 --                                                                          --
  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 2,  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 COPYING.  If not, write --
  19 -- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
  20 -- Boston, MA 02110-1301, USA.                                              --
  21 --                                                                          --
  22 -- GNAT was originally developed  by the GNAT team at  New York University. --
  23 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  24 --                                                                          --
  25 ------------------------------------------------------------------------------
  26
  27 with Osint;  use Osint;
  28 with Output; use Output;
  29
  30 package body Bindusg is
  31
  32    Already_Displayed : Boolean := False;
  33    --  Set True if Display called, used to avoid showing usage information
  34    --  more than once.
  35
  36    -------------
  37    -- Display --
  38    -------------
  39
  40    procedure Display is
  41    begin
  42       if Already_Displayed then
  43          return;
  44       else
  45          Already_Displayed := True;
  46       end if;
  47
  48       --  Usage line
  49
  50       Write_Str ("Usage: ");
  51       Write_Program_Name;
  52       Write_Char (' ');
  53       Write_Str ("switches lfile");
  54       Write_Eol;
  55       Write_Eol;
  56
  57       --  Line for @response_file
  58
  59       Write_Line ("  @<resp_file> Get arguments from response file");
  60       Write_Eol;
  61
  62       --  Line for -aO switch
  63
  64       Write_Line ("  -aOdir    Specify library files search path");
  65
  66       --  Line for -aI switch
  67
  68       Write_Line ("  -aIdir    Specify source files search path");
  69
  70       --  Line for a switch
  71
  72       Write_Line ("  -a        Automatically initialize elaboration " &
  73                   "procedure");
  74
  75       --  Line for A switch
  76
  77       Write_Line ("  -A        Generate binder program in Ada (default)");
  78
  79       --  Line for -b switch
  80
  81       Write_Line ("  -b        Generate brief messages to stderr " &
  82                   "even if verbose mode set");
  83
  84       --  Line for -c switch
  85
  86       Write_Line ("  -c        Check only, no generation of " &
  87                   "binder output file");
  88
  89       --  Line for C switch
  90
  91       Write_Line ("  -C        Generate binder program in C");
  92
  93       --  Line for -d switch
  94
  95       Write_Line ("  -dnn[k|m] Default primary stack " &
  96                   "size = nn [kilo|mega] bytes");
  97
  98       --  Line for D switch
  99
 100       Write_Line ("  -Dnn[k|m] Default secondary stack " &
 101                   "size = nnn [kilo|mega] bytes");
 102
 103       --  Line for -e switch
 104
 105       Write_Line ("  -e        Output complete list of elaboration " &
 106                   "order dependencies");
 107
 108       --  Line for -E switch
 109
 110       Write_Line ("  -E        Store tracebacks in Exception occurrences");
 111
 112       --  The -f switch is voluntarily omitted, because it is obsolete
 113
 114       --  Line for -F switch
 115
 116       Write_Line ("  -F        Force checking of elaboration Flags");
 117
 118       --  Line for -h switch
 119
 120       Write_Line ("  -h        Output this usage (help) information");
 121
 122       --  Lines for -I switch
 123
 124       Write_Line ("  -Idir     Specify library and source files search path");
 125       Write_Line ("  -I-       Don't look for sources & library files " &
 126                   "in default directory");
 127
 128       --  Line for -K switch
 129
 130       Write_Line ("  -K        Give list of linker options specified " &
 131                   "for link");
 132
 133       --  Line for -l switch
 134
 135       Write_Line ("  -l        Output chosen elaboration order");
 136
 137       --  Line of -L switch
 138
 139       Write_Line ("  -Lxyz     Library build: adainit/final " &
 140                   "renamed to xyzinit/final, implies -n");
 141
 142       --  Line for -m switch
 143
 144       Write_Line ("  -mnnn     Limit number of detected errors " &
 145                   "to nnn (1-999999)");
 146
 147       --  Line for -M switch
 148
 149       Write_Line ("  -Mxyz     Rename generated main program from " &
 150                   "main to xyz");
 151
 152       --  Line for -n switch
 153
 154       Write_Line ("  -n        No Ada main program (foreign main routine)");
 155
 156       --  Line for -nostdinc
 157
 158       Write_Line ("  -nostdinc Don't look for source files " &
 159                   "in the system default directory");
 160
 161       --  Line for -nostdlib
 162
 163       Write_Line ("  -nostdlib Don't look for library files " &
 164                   "in the system default directory");
 165
 166       --  Line for -o switch
 167
 168       Write_Line ("  -o file   Give the output file name " &
 169                   "(default is b~xxx.adb)");
 170
 171       --  Line for -O switch
 172
 173       Write_Line ("  -O        Give list of objects required for link");
 174
 175       --  Line for -p switch
 176
 177       Write_Line ("  -p        Pessimistic (worst-case) elaboration order");
 178
 179       --  Line for -r switch
 180
 181       Write_Line ("  -r        List restrictions that could be applied " &
 182                   "to this partition");
 183
 184       --  Line for -R switch
 185
 186       Write_Line
 187         ("  -R        List sources referenced in closure (implies -c)");
 188
 189       --  Line for -s switch
 190
 191       Write_Line ("  -s        Require all source files to be present");
 192
 193       --  Line for -S?? switch
 194
 195       Write_Line ("  -S??      Sin/lo/hi/xx/ev Initialize_Scalars " &
 196                   "invalid/low/high/hex/env var");
 197
 198       --  Line for -static
 199
 200       Write_Line ("  -static   Link against a static GNAT run time");
 201
 202       --  Line for -shared
 203
 204       Write_Line ("  -shared   Link against a shared GNAT run time");
 205
 206       --  Line for -t switch
 207
 208       Write_Line ("  -t        Tolerate time stamp and other " &
 209                   "consistency errors");
 210
 211       --  Line for -T switch
 212
 213       Write_Line ("  -Tn       Set time slice value to n " &
 214                   "milliseconds (n >= 0)");
 215
 216       --  Line for -u switch
 217
 218       Write_Line ("  -un       Enable dynamic stack analysis, with " &
 219                   "n results stored");
 220
 221       --  Line for -v switch
 222
 223       Write_Line ("  -v        Verbose mode. Error messages, " &
 224                   "header, summary output to stdout");
 225
 226       --  Lines for -w switch
 227
 228       Write_Line ("  -wx       Warning mode. (x=s/e for " &
 229                   "suppress/treat as error)");
 230
 231       --  Line for -x switch
 232
 233       Write_Line ("  -x        Exclude source files (check object " &
 234                   "consistency only)");
 235
 236       --  Line for X switch
 237
 238       Write_Line ("  -Xnnn     Default exit status value = nnn");
 239
 240       --  Line for -z switch
 241
 242       Write_Line ("  -z        No main subprogram (zero main)");
 243
 244       --  Line for --RTS
 245
 246       --  Line for -Z switch
 247
 248       Write_Line ("  -Z        " &
 249                   "Zero formatting in auxiliary outputs (-e, -K, -l, -R)");
 250
 251       --  Line for --RTS
 252
 253       Write_Line ("  --RTS=dir specify the default source and " &
 254                   "object search path");
 255
 256       --  Line for sfile
 257
 258       Write_Line ("  lfile     Library file names");
 259    end Display;
 260
 261 end Bindusg;