gcc/m2/lang-options.h

   1 /* Definitions for switches for Modula-2.
   2
   3 Copyright (C) 2001-2021 Free Software Foundation, Inc.
   4 Contributed by Gaius Mulley <gaius@glam.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 #define LINK_COMMAND_SPEC ""
  23
  24 /* This is the contribution to the `documented_lang_options' array in
  25    toplev.c for gm2.  */
  26
  27 DEFINE_LANG_NAME ("Modula-2")
  28
  29   { "-I",
  30       N_("specifies a library path (C syntax)") },
  31   { "-fiso",
  32       N_("use ISO dialect of Modula-2") },
  33   { "-fpim",
  34       N_("use PIM [234] dialect of Modula-2") },
  35   { "-fpim2",
  36       N_("use PIM 2 dialect of Modula-2") },
  37   { "-fpim3",
  38       N_("use PIM 3 dialect of Modula-2") },
  39   { "-fpim4",
  40       N_("use PIM 4 dialect of Modula-2") },
  41   { "-fpositive-mod-floor-div",
  42       N_("force positive result from MOD and DIV result floor") },
  43   { "-flibs=ulm",
  44       N_("use the University of Ulm libraries and PIM dialect of Modula-2") },
  45   { "-flibs=min",
  46       N_("use a minimal SYSTEM, M2RTS and libc and no other system libraries") },
  47   { "-flibs=logitech",
  48       N_("use the Logitech compatible (PIM dialect) set of libraries") },
  49   { "-flibs=pim-coroutine",
  50       N_("use the PIM dialect libraries which include coroutine support") },
  51   { "-fnil",
  52       N_("turns on runtime checking to detect accessing data through a NIL value pointer") },
  53   { "-fno-nil",
  54       N_("turns off runtime checking to detect accessing data through a NIL value pointer") },
  55   { "-fwholediv",
  56       N_("generate code to detect whole number division by zero or modulus by zero") },
  57   { "-fno-wholediv",
  58       N_("do not generate code to detect whole number division by zero or modulus by zero") },
  59   { "-findex",
  60       N_("generate code to check whether array index values are out of bounds") },
  61   { "-fno-index",
  62       N_("do not generate code to check whether array index values are out of bounds") },
  63   { "-frange",
  64       N_("generate code to check the assignment range, return value range, set range and constructor range") },
  65   { "-fno-range",
  66       N_("do not generate code to check the assignment range, return value range, set range and constructor range") },
  67   { "-freturn",
  68       N_("turns on runtime checking for functions which finish without executing a RETURN statement") },
  69   { "-fno-return",
  70       N_("turns off runtime checking for functions which finish without executing a RETURN statement") },
  71   { "-fcase",
  72       N_("turns on runtime checking to check whether a CASE statement requires an ELSE clause when on was not specified") },
  73   { "-fno-case",
  74       N_("turns off runtime checking to check whether a CASE statement requires an ELSE clause when on was not specified") },
  75   { "-fsoft-check-all",
  76       N_("turns on all runtime checking (an abbreviation for -fnil -frange -findex -fwholediv -fcase -freturn-ffloatvalue)") },
  77   { "-fno-soft-check-all",
  78       N_("turns off all runtime checking (an abbreviation for -fno-nil -fno-range -fno-index -fno-wholediv -fno-case -fno-return -fno-floatvalue)") },
  79   { "-fexceptions",
  80       N_("turns on all exception generating code (this is on by default)") },
  81   { "-fno-exceptions",
  82       N_("turns off all exception generating code, this flag should be used with -flibs=min") },
  83   { "-fauto-init",
  84       N_("automatically initializes all pointers to NIL") },
  85   { "-Wstudents",
  86       N_("extra compile time semantic checking, typically tries to catch bad style") },
  87   { "-Wpedantic",
  88       N_("compiler checks nested WITH statements (referencing same type) and multiple identical imports") },
  89   { "-Wpedantic-param-names",
  90       N_("compiler checks to force definition module procedure parameter names with their implementation module counterpart") },
  91   { "-Wpedantic-cast",
  92       N_("compiler warns if a cast is being used on types of differing sizes") },
  93   { "-fextended-opaque",
  94       N_("allows opaque types to be implemented as any type (a GNU Modula-2 extension)") },
  95   { "-Wverbose-unbounded",
  96       N_("inform user which parameters will be passed by reference") },
  97   { "-Wunused-variable",
  98       N_("compiler warns if a variable is declared and not used") },
  99   { "-Wno-unused-variable",
 100       N_("turns off compiler warning if a variable is declared and not used") },
 101   { "-Wunused-parameter",
 102       N_("compiler warns if a parameter is declared and not used") },
 103   { "-Wno-unused-parameter",
 104       N_("turns off compiler warning if a parameter is declared and not used") },
 105   { "-fxcode",
 106       N_("issue all errors and warnings in the Xcode format") },
 107   { "-fuselist",
 108       N_("use ordered list of modules when linking") },
 109   { "-fmakelist",
 110       N_("created ordered list of modules") },
 111   { "-fm2-whole-program",
 112       N_("compile all implementation and program modules as a single unit") },
 113   { "-fm2-statistics",
 114       N_("display statistics about the amount of source lines compiled and symbols used") },
 115   { "-fm2-g",
 116       N_("generate extra nops to improve debugging, producing an instruction for every code related keyword") },
 117   { "-fm2-lower-case",
 118       N_("generate error messages which render keywords in lower case") },
 119   { "-fmodules",
 120       N_("display list of modules and location") },
 121   { "-fno-pthread",
 122       N_("do not link against -lpthread") },
 123   { "-fruntime-modules=",
 124       N_("specify the list of runtime modules and their initialization order") },
 125   { "-fclean",
 126       N_("cleans all the project objects in the current directory using make") },
 127   { "-fmakeall",
 128       N_("build a project using make") },
 129   { "-fmakeall0",
 130       N_("do not build a project using make (internal)") },
 131   { "-fmake-I=",
 132       N_("build project path (internal)") },
 133   { "-ftarget-ar=",
 134       N_("full path to target archiver") },
 135   { "-ftarget-ranlib=",
 136       N_("full path to target ranlib") },
 137   { "-fcpp",
 138       N_("use cpp to preprocess the module") },
 139   { "-fq",
 140       N_("debugging information - dump the list of quadruples") },
 141   { "-fsources",
 142       N_("display the location of module source files as they are compiled") },
 143   { "-funbounded-by-reference",
 144       N_("optimize non var unbounded parameters by passing it by reference, providing it is not written to within the callee procedure.") },
 145   { "-fdef=",
 146       N_("recognise the specified suffix as a definition module filename") },
 147   { "-fmod=",
 148       N_("recognise the specified suffix as implementation and module filenames") },
 149   { "-fdump-system-exports",
 150       N_("display all inbuilt system items") },
 151   { "-fswig",
 152       N_("generate a swig interface file") },
 153   { "-fshared",
 154       N_("generate a shared library from the module") },
 155   { "-fmakeinit",
 156       N_("generate the start up C code for the module, a file _m2_modulename.c is created") },
 157   { "-fobject-path=",
 158       N_("set the object path") },
 159   { "-fonlylink",
 160       N_("only link the module and do not compile module (internal)"),
 161   { "--version",
 162       N_("display the GNU Modula-2 version") },
 163   { "-fversion",
 164       N_("display the GNU Modula-2 version") },
 165   { "-fm2-version",
 166       N_("display the GNU Modula-2 version") },
 167   { "-O",
 168       N_("optimize code") },
 169   { "-flocation=",
 170       N_("set all location values to unknown,builtin,integer value (internal debugging)") },
 171   { "-x",
 172       N_("specify the language") },
 173   { "-fdebug-function-line-numbers",
 174       N_("turn on the Modula-2 function line number generation (internal switch)") },
 175   { "-ffloatvalue",
 176       N_("generate code to detect floating point overflow and underflow") },
 177   { "-fno-floatvalue",
 178       N_("do not generate code to detect floating point overflow and underflow") },
 179   { "-fwholevalue",
 180       N_("generate code to detect whole number overflow and underflow") },
 181   { "-fno-wholevalue",
 182       N_("do not generate code to detect whole number overflow and underflow") },
 183   { "-fm2-plugin",
 184       N_("insert semantic plugin to detect runtime errors at compile time") },
 185   { "-fno-m2-plugin",
 186       N_("do not insert semantic plugin to detect runtime errors at compile time") },
 187   { "-fsave-temps",
 188       N_("save temporary files after the preprocessor phase") },
 189   { "-fsave-temps=",
 190       N_("save temporary files and place them in the directory specified") },