gcc/m2/lang.opt

   1 ; Options for the Modula-2 front end.
   2 ;
   3 ; Copyright (C) 2016-2024 Free Software Foundation, Inc.
   4 ; Contributed by Gaius Mulley <gaius.mulley@southwales.ac.uk>.
   5 ;
   6 ; This file is part of GNU Modula-2.
   7 ;
   8 ; GNU Modula-2 is free software; you can redistribute it and/or modify
   9 ; it under the terms of the GNU General Public License as published by
  10 ; the Free Software Foundation; either version 3, or (at your option)
  11 ; any later version.
  12 ;
  13 ; GNU Modula-2 is distributed in the hope that it will be useful, but
  14 ; WITHOUT ANY WARRANTY; without even the implied warranty of
  15 ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 ; General Public License for more details.
  17 ;
  18 ; You should have received a copy of the GNU General Public License
  19 ; along with GNU Modula-2; see the file COPYING.  If not,
  20 ; see <https://www.gnu.org/licenses/>.  *)
  21
  22 ; See the GCC internals manual for a description of this file's format.
  23
  24 ; There are two sections:
  25 ;  1. Options specific to Modula-2
  26 ;  2. Options shared with C or the Driver.
  27 ; Please keep any new additions for either case in the relevant section.
  28 ; Please try to keep this file in ASCII collating order.
  29
  30 Language
  31 Modula-2
  32
  33 Wcase-enum
  34 Modula-2
  35 turns on case statement label compile time checking when using an expression of an enum type.
  36
  37 Wpedantic-param-names
  38 Modula-2
  39 compiler checks to force definition module procedure parameter names with their implementation module counterpart
  40
  41 Wpedantic-cast
  42 Modula-2
  43 compiler warns if a cast is being used on types of differing sizes
  44
  45 Wverbose-unbounded
  46 Modula-2
  47 inform user which parameters will be passed by reference
  48
  49 Wstyle
  50 Modula-2
  51 extra compile time semantic checking, typically tries to catch poor programming style
  52
  53 Wuninit-variable-checking
  54 Modula-2
  55 turns on compile time analysis in the first basic block of a procedure detecting access to uninitialized data.
  56
  57 Wuninit-variable-checking=
  58 Modula-2 Joined
  59 turns on compile time analysis to detect access to uninitialized variables, the checking can be specified by: known,cond,all.
  60
  61 fauto-init
  62 Modula-2
  63 automatically initializes all pointers to NIL
  64
  65 fbounds
  66 Modula-2
  67 turns on runtime subrange, array index and indirection via NIL pointer checking
  68
  69 fcase
  70 Modula-2
  71 turns on runtime checking to check whether a CASE statement requires an ELSE clause when one was not specified
  72
  73 fcpp
  74 Modula-2
  75 use cpp to preprocess the module
  76
  77 fcpp-end
  78 Modula-2
  79 passed to the preprocessor if -fcpp is used (internal switch)
  80
  81 fcpp-begin
  82 Modula-2
  83 passed to the preprocessor if -fcpp is used (internal switch)
  84
  85 fdebug-builtins
  86 Modula-2
  87 call a real function, rather than the builtin equivalent
  88
  89 fd
  90 Modula-2
  91 turn on internal debugging of the compiler (internal switch)
  92
  93 fdebug-trace-quad
  94 Modula-2
  95 turn on quadruple tracing (internal switch)
  96
  97 fdebug-trace-api
  98 Modula-2
  99 turn on the Modula-2 api tracing (internal switch)
 100
 101 fdebug-function-line-numbers
 102 Modula-2
 103 turn on the Modula-2 function line number generation (internal switch)
 104
 105 fdef=
 106 Modula-2 Joined
 107 recognise the specified suffix as a definition module filename
 108
 109 fdump-system-exports
 110 Modula-2
 111 display all inbuilt system items
 112
 113 fextended-opaque
 114 Modula-2
 115 allows opaque types to be implemented as any type (a GNU Modula-2 extension)
 116
 117 ffloatvalue
 118 Modula-2
 119 turns on runtime checking to check whether a floating point number will exceed range
 120
 121 fgen-module-list=
 122 Modula-2 Joined
 123 create a topologically sorted module list from all dependent modules used in the application
 124
 125 findex
 126 Modula-2
 127 turns on all range checking for numerical values
 128
 129 fiso
 130 Modula-2
 131 use ISO dialect of Modula-2
 132
 133 flibs=
 134 Modula-2 Joined
 135 specify the library order, the libraries may be specified by a comma separated abbreviation: log,min,pim,iso or by directory names: m2log,m2min,m2pim,m2iso.
 136
 137 flocation=
 138 Modula-2 Joined
 139 set all location values to a specific value (internal switch)
 140
 141 fm2-g
 142 Modula-2
 143 generate extra nops to improve debugging, producing an instruction for every code related keyword
 144
 145 fm2-lower-case
 146 Modula-2
 147 generate error messages which render keywords in lower case
 148
 149 fm2-pathname=
 150 Modula-2 Joined
 151 specify the module mangled prefix name for all modules in the following include paths
 152
 153 fm2-pathnameI
 154 Modula-2 Joined
 155 ; For internal use only: used by the driver to copy the user facing -I option
 156
 157 fm2-plugin
 158 Modula-2
 159 insert plugin to identify runtime errors at compiletime
 160
 161 fm2-prefix=
 162 Modula-2 Joined
 163 specify the module mangled prefix name
 164
 165 fm2-statistics
 166 Modula-2
 167 display statistics about the amount of source lines compiled and symbols used
 168
 169 fm2-strict-type
 170 Modula-2
 171 experimental flag to turn on the new strict type checker
 172
 173 fm2-whole-program
 174 Modula-2
 175 compile all implementation modules and program module at once
 176
 177 fmod=
 178 Modula-2 Joined
 179 recognise the specified suffix as implementation and module filenames
 180
 181 fnil
 182 Modula-2
 183 turns on runtime checking to detect accessing data through a NIL value pointer
 184
 185 fpim
 186 Modula-2
 187 use PIM [234] dialect of Modula-2
 188
 189 fpim2
 190 Modula-2
 191 use PIM 2 dialect of Modula-2
 192
 193 fpim3
 194 Modula-2
 195 use PIM 3 dialect of Modula-2
 196
 197 fpim4
 198 Modula-2
 199 use PIM 4 dialect of Modula-2
 200
 201 fpositive-mod-floor-div
 202 Modula-2
 203 force positive result from MOD and DIV result floor
 204
 205 fpthread
 206 Modula-2
 207 link against the pthread library (default on)
 208
 209 fq
 210 Modula-2
 211 internal compiler debugging information, dump the list of quadruples
 212
 213 frange
 214 Modula-2
 215 turns on all range checking for numerical values
 216
 217 freturn
 218 Modula-2
 219 turns on runtime checking for functions which finish without executing a RETURN statement
 220
 221 fruntime-modules=
 222 Modula-2 Joined
 223 specify the list of runtime modules and their initialization order
 224
 225 fscaffold-dynamic
 226 Modula-2
 227 the modules initialization order is dynamically determined by M2RTS and application dependencies
 228
 229 fscaffold-c
 230 Modula-2
 231 generate a C source scaffold for the current module being compiled
 232
 233 fscaffold-c++
 234 Modula-2
 235 generate a C++ source scaffold for the current module being compiled
 236
 237 fscaffold-main
 238 Modula-2
 239 generate the main function
 240
 241 fscaffold-static
 242 Modula-2
 243 generate static scaffold initialization and finalization for every module inside main
 244
 245 fshared
 246 Modula-2
 247 generate a shared library from the module
 248
 249 fsoft-check-all
 250 Modula-2
 251 turns on all software runtime checking (an abbreviation for -fnil -frange -findex -fwholediv -fcase -freturn -fwholevalue -ffloatvalue)
 252
 253 fsources
 254 Modula-2
 255 display the location of module source files as they are compiled
 256
 257 fswig
 258 Modula-2
 259 create a swig interface file for the module
 260
 261 funbounded-by-reference
 262 Modula-2
 263 optimize non var unbounded parameters by passing it by reference, providing it is not written to within the callee procedure.
 264
 265 fuse-list=
 266 Modula-2 Joined
 267 orders the initialization/finalializations for scaffold-static or force linking of modules if scaffold-dynamic
 268
 269 fversion
 270 Modula-2
 271 ; Documented in common.opt
 272
 273 fwholediv
 274 Modula-2
 275 turns on all division and modulus by zero checking for ordinal values
 276
 277 fwholevalue
 278 Modula-2
 279 turns on runtime checking to check whether a whole number will exceed range
 280
 281 static-libgm2
 282 Driver
 283 Link the standard Modula-2 libraries statically in the compilation.
 284
 285 ; Here are C options that we also recognise, either within the compiler
 286 ; or to build the preprocessor command lines.
 287
 288 Wall
 289 Modula-2
 290 ; Documented in c.opt
 291
 292 Wpedantic
 293 Modula-2
 294 ; Documented in common.opt
 295
 296 Wreturn-type
 297 Modula-2
 298 ; Documented in common.opt
 299
 300 Wunused-variable
 301 Modula-2
 302 ; Documented in c.opt
 303
 304 Wunused-parameter
 305 Modula-2
 306 ; Documented in c.opt
 307
 308 B
 309 Modula-2
 310 ; Documented in c.opt
 311
 312 D
 313 Modula-2
 314 ; Documented in c.opt
 315
 316 E
 317 Modula-2
 318 ; Documented in c.opt
 319
 320 I
 321 Modula-2 Joined Separate
 322 ; Documented in c.opt
 323
 324 L
 325 Modula-2 Joined Separate
 326 ; Not documented
 327
 328 M
 329 Modula-2
 330 ; Documented in c.opt
 331
 332 MD
 333 Modula-2
 334 ; Documented in c.opt
 335
 336 MF
 337 Modula-2
 338 ; Documented in c.opt
 339
 340 MG
 341 Modula-2
 342 ; Documented in c.opt
 343
 344 MM
 345 Modula-2
 346 ; Documented in c.opt
 347
 348 MMD
 349 Modula-2
 350 ; Documented in c.opt
 351
 352 Mmodules
 353 Modula-2
 354 ; Documented in c.opt
 355
 356 Mno-modules
 357 Modula-2
 358 ; Documented in c.opt
 359
 360 MP
 361 Modula-2
 362 ; Documented in c.opt
 363
 364 MQ
 365 Modula-2
 366 ; Documented in c.opt
 367
 368 MT
 369 Modula-2
 370 ; Documented in c.opt
 371
 372 P
 373 Modula-2
 374 ; Documented in c.opt
 375
 376 ansi
 377 Modula-2
 378 ; Documented in c.opt
 379
 380 c
 381 Modula-2
 382 ; Documented in c.opt
 383
 384 fexceptions
 385 Modula-2
 386 ; Documented in common.opt
 387
 388 fobjc-std=objc1
 389 Modula-2
 390 ; Documented in c.opt
 391
 392 fpreprocessed
 393 Modula-2
 394 ; Documented in c.opt
 395
 396 fworking-directory
 397 Modula-2
 398 ; Documented in c.opt
 399
 400 iprefix
 401 Modula-2
 402 ; Documented in c.opt
 403
 404 iquote
 405 Modula-2
 406 ; Documented in c.opt
 407
 408 isysroot
 409 Modula-2
 410 ; Documented in c.opt
 411
 412 isystem
 413 Modula-2
 414 ; Documented in c.opt
 415
 416 idirafter
 417 Modula-2
 418 ; Documented in c.opt
 419
 420 imultilib
 421 Modula-2
 422
 423 -save-temps
 424 Modula-2 Alias(save-temps)
 425
 426 save-temps
 427 Modula-2
 428 save temporary preprocessed files
 429
 430 save-temps=
 431 Modula-2 Joined
 432 save temporary preprocessed files
 433
 434 traditional-cpp
 435 Modula-2
 436 ; Documented in c.opt
 437
 438 ; This comment is to ensure we retain the blank line above.