* ggc.h (empty_string): Delete.
[official-gcc.git] / gcc / fortran / lang.opt
blob4421ce4268721c73ab78ad34218240d8b9133720
1 ; Options for the Fortran 95 front end.
2 ; Copyright (C) 2003-2017 Free Software Foundation, Inc.
4 ; This file is part of GCC.
6 ; GCC is free software; you can redistribute it and/or modify it under
7 ; the terms of the GNU General Public License as published by the Free
8 ; Software Foundation; either version 3, or (at your option) any later
9 ; version.
10
11 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 ; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14 ; for more details.
15
16 ; You should have received a copy of the GNU General Public License
17 ; along with GCC; see the file COPYING3.  If not see
18 ; <http://www.gnu.org/licenses/>.
20 ; See the GCC internals manual for a description of this file's format.
22 ; Please try to keep this file in ASCII collating order.
24 Language
25 Fortran
27 -all-warnings
28 Fortran Alias(Wall)
30 -assert
31 Fortran Separate Alias(A)
33 -assert=
34 Fortran Joined Alias(A)
36 -comments
37 Fortran Alias(C)
39 -comments-in-macros
40 Fortran Alias(CC)
42 -define-macro
43 Fortran Separate Alias(D)
45 -define-macro=
46 Fortran Joined Alias(D)
48 -dependencies
49 Fortran Alias(M)
51 -dump
52 Fortran Separate Alias(d)
54 -dump=
55 Fortran Joined Alias(d)
57 -include-barrier
58 Fortran Alias(I, -)
60 -include-directory
61 Fortran Separate Alias(I)
63 -include-directory=
64 Fortran Joined Alias(I)
66 -include-directory-after
67 Fortran Separate Alias(idirafter)
69 -include-directory-after=
70 Fortran Joined Alias(idirafter)
72 -include-prefix
73 Fortran Separate Alias(iprefix)
75 -include-prefix=
76 Fortran JoinedOrMissing Alias(iprefix)
78 -no-line-commands
79 Fortran Alias(P)
81 -no-standard-includes
82 Fortran Alias(nostdinc)
84 -output
85 Fortran Separate Alias(o)
87 -output=
88 Fortran Joined Alias(o)
90 -preprocess
91 Fortran Undocumented Alias(E)
93 -print-missing-file-dependencies
94 Fortran Alias(MG)
96 -trace-includes
97 Fortran Alias(H)
99 -undefine-macro
100 Fortran Separate Alias(U)
102 -undefine-macro=
103 Fortran Joined Alias(U)
105 -user-dependencies
106 Fortran Alias(MM)
108 -verbose
109 Fortran Alias(v)
111 -write-dependencies
112 Fortran NoDriverArg Separate Alias(MD)
114 -write-user-dependencies
115 Fortran NoDriverArg Separate Alias(MMD)
118 Fortran Joined Separate
119 ; Documented in C
122 Fortran
123 ; Documented in C
126 Fortran
127 ; Documented in C
130 Fortran Joined Separate
131 ; Documented in C
134 Fortran Undocumented
137 Fortran
138 ; Documented in C
141 Fortran Joined Separate
142 ; Documented in C
145 Fortran Joined Separate
146 -J<directory>   Put MODULE files in 'directory'.
149 Fortran
150 ; Documented in C
153 Fortran Separate NoDriverArg
154 ; Documented in C
157 Fortran Joined Separate
158 ; Documented in C
161 Fortran
162 ; Documented in C
165 Fortran
166 ; Documented in C
169 Fortran Separate NoDriverArg
170 ; Documented in C
173 Fortran
174 ; Documented in C
177 Fortran Joined Separate
178 ; Documented in C
181 Fortran Joined Separate
182 ; Documented in C
185 Fortran
186 ; Documented in C
189 Fortran Joined Separate
190 ; Documented in C
192 Wall
193 Fortran
194 ; Documented in C
196 Waliasing
197 Fortran Warning Var(warn_aliasing) LangEnabledBy(Fortran,Wall)
198 Warn about possible aliasing of dummy arguments.
200 Walign-commons
201 Fortran Warning Var(warn_align_commons) Init(1)
202 Warn about alignment of COMMON blocks.
204 Wampersand
205 Fortran Warning Var(warn_ampersand) LangEnabledBy(Fortran,Wall || Wpedantic)
206 Warn about missing ampersand in continued character constants.
208 Warray-temporaries
209 Fortran Warning Var(warn_array_temporaries)
210 Warn about creation of array temporaries.
212 Wargument-mismatch
213 Fortran Warning Var(warn_argument_mismatch) Init(1)
214 Warn about type and rank mismatches between arguments and parameters.
216 Wc-binding-type
217 Fortran Var(warn_c_binding_type) Warning LangEnabledBy(Fortran,Wall)
218 Warn if the type of a variable might be not interoperable with C.
220 Wdate-time
221 Fortran
222 ; Documented in C
224 Wcharacter-truncation
225 Fortran Var(warn_character_truncation) Warning LangEnabledBy(Fortran,Wall)
226 Warn about truncated character expressions.
228 Wcompare-reals
229 Fortran Warning Var(warn_compare_reals) LangEnabledBy(Fortran,Wextra)
230 Warn about equality comparisons involving REAL or COMPLEX expressions.
232 Wconversion
233 Fortran Var(warn_conversion) Warning LangEnabledBy(Fortran,Wall)
234 ; Documented in C
236 Wconversion-extra
237 Fortran Var(warn_conversion_extra) Warning
238 Warn about most implicit conversions.
240 Wextra
241 Fortran Warning
242 ; Documented in common
244 Wfunction-elimination
245 Fortran Warning Var(warn_function_elimination)
246 Warn about function call elimination.
248 Wimplicit-interface
249 Fortran Warning Var(warn_implicit_interface)
250 Warn about calls with implicit interface.
252 Wimplicit-procedure
253 Fortran Warning Var(warn_implicit_procedure)
254 Warn about called procedures not explicitly declared.
256 Winteger-division
257 Fortran Warning Var(warn_integer_division) LangEnabledBy(Fortran,Wall)
258 Warn about constant integer divisions with truncated results.
260 Wline-truncation
261 Fortran Warning Var(warn_line_truncation) LangEnabledBy(Fortran,Wall) Init(-1)
262 Warn about truncated source lines.
264 Wintrinsics-std
265 Fortran Var(warn_intrinsics_std) Warning LangEnabledBy(Fortran,Wall)
266 Warn on intrinsics not part of the selected standard.
268 Wmaybe-uninitialized
269 Fortran LangEnabledBy(Fortran,Wall)
270 ; Documented in common.opt
272 Wmissing-include-dirs
273 Fortran
274 ; Documented in C/C++
276 Wuse-without-only
277 Fortran Var(warn_use_without_only) Warning
278 Warn about USE statements that have no ONLY qualifier.
280 Wopenmp-simd
281 Fortran
282 ; Documented in C
284 Wpedantic
285 Fortran
286 ; Documented in common.opt
288 Wreal-q-constant
289 Fortran Warning Var(warn_real_q_constant) LangEnabledBy(Fortran,Wall)
290 Warn about real-literal-constants with 'q' exponent-letter.
292 Wrealloc-lhs
293 Fortran Warning Var(warn_realloc_lhs) LangEnabledBy(Fortran,Wrealloc-lhs-all)
294 Warn when a left-hand-side array variable is reallocated.
296 Wrealloc-lhs-all
297 Fortran Warning Var(warn_realloc_lhs_all)
298 Warn when a left-hand-side variable is reallocated.
300 Wtarget-lifetime
301 Fortran Warning Var(warn_target_lifetime) LangEnabledBy(Fortran,Wall)
302 Warn if the pointer in a pointer assignment might outlive its target.
304 Wreturn-type
305 Fortran Warning LangEnabledBy(Fortran,Wall)
306 ; Documented in C
308 Wsurprising
309 Fortran Warning Var(warn_surprising) LangEnabledBy(Fortran,Wall)
310 Warn about \"suspicious\" constructs.
312 Wtabs
313 Fortran Warning Var(warn_tabs) LangEnabledBy(Fortran,Wall || Wpedantic)
314 Permit nonconforming uses of the tab character.
316 Wundefined-do-loop
317 Fortran Warning Var(warn_undefined_do_loop) LangEnabledBy(Fortran,Wall)
318 Warn about an invalid DO loop.
320 Wunderflow
321 Fortran Warning Var(warn_underflow) Init(1)
322 Warn about underflow of numerical constant expressions.
324 Wuninitialized
325 Fortran LangEnabledBy(Fortran,Wall)
326 ; Documented in common.opt
328 Wintrinsic-shadow
329 Fortran Warning Var(warn_intrinsic_shadow) LangEnabledBy(Fortran,Wall)
330 Warn if a user-procedure has the same name as an intrinsic.
332 Wunused
333 LangEnabledBy(Fortran,Wall)
334 ; Documented in common.opt
336 Wunused-dummy-argument
337 Fortran Warning Var(warn_unused_dummy_argument) LangEnabledBy(Fortran,Wall)
338 Warn about unused dummy arguments.
340 Wzerotrip
341 Fortran Warning Var(warn_zerotrip) LangEnabledBy(Fortran,Wall)
342 Warn about zero-trip DO loops.
345 Fortran Negative(nocpp)
346 Enable preprocessing.
348 cpp=
349 Fortran Joined Negative(nocpp) Undocumented NoDWARFRecord
350 ; Internal option generated by specs from -cpp.
352 nocpp
353 Fortran Negative(cpp)
354 Disable preprocessing.
357 Fortran Joined
358 ; Documented in common.opt
360 faggressive-function-elimination
361 Fortran Var(flag_aggressive_function_elimination)
362 Eliminate multiple function invocations also for impure functions.
364 falign-commons
365 Fortran Var(flag_align_commons) Init(1)
366 Enable alignment of COMMON blocks.
368 fall-intrinsics
369 Fortran RejectNegative Var(flag_all_intrinsics)
370 All intrinsics procedures are available regardless of selected standard.
372 fallow-leading-underscore
373 Fortran Undocumented Var(flag_allow_leading_underscore)
374 ; For internal use only: allow the first character of symbol names to be an underscore
376 fautomatic
377 Fortran Var(flag_automatic) Init(1)
378 Do not treat local variables and COMMON blocks as if they were named in SAVE statements.
380 fbackslash
381 Fortran Var(flag_backslash)
382 Specify that backslash in string introduces an escape character.
384 fbacktrace
385 Fortran Var(flag_backtrace) Init(1)
386 Produce a backtrace when a runtime error is encountered.
388 fblas-matmul-limit=
389 Fortran RejectNegative Joined UInteger Var(flag_blas_matmul_limit) Init(30)
390 -fblas-matmul-limit=<n> Size of the smallest matrix for which matmul will use BLAS.
392 fcheck-array-temporaries
393 Fortran
394 Produce a warning at runtime if a array temporary has been created for a procedure argument.
396 fconvert=
397 Fortran RejectNegative Joined Enum(gfc_convert) Var(flag_convert) Init(GFC_FLAG_CONVERT_NATIVE)
398 -fconvert=<big-endian|little-endian|native|swap> The endianness used for unformatted files.
400 Enum
401 Name(gfc_convert) Type(enum gfc_convert) UnknownError(Unrecognized option to endianness value: %qs)
403 EnumValue
404 Enum(gfc_convert) String(big-endian) Value(GFC_FLAG_CONVERT_BIG)
406 EnumValue
407 Enum(gfc_convert) String(little-endian) Value(GFC_FLAG_CONVERT_LITTLE)
409 EnumValue
410 Enum(gfc_convert) String(native) Value(GFC_FLAG_CONVERT_NATIVE)
412 EnumValue
413 Enum(gfc_convert) String(swap) Value(GFC_FLAG_CONVERT_SWAP)
415 fcray-pointer
416 Fortran Var(flag_cray_pointer)
417 Use the Cray Pointer extension.
419 fd-lines-as-code
420 Fortran RejectNegative
421 Ignore 'D' in column one in fixed form.
423 fd-lines-as-comments
424 Fortran RejectNegative
425 Treat lines with 'D' in column one as comments.
427 fdec
428 Fortran Var(flag_dec)
429 Enable all DEC language extensions.
431 fdec-intrinsic-ints
432 Fortran Var(flag_dec_intrinsic_ints)
433 Enable kind-specific variants of integer intrinsic functions.
435 fdec-math
436 Fortran Var(flag_dec_math)
437 Enable legacy math intrinsics for compatibility.
439 fdec-structure
440 Fortran Var(flag_dec_structure)
441 Enable support for DEC STRUCTURE/RECORD.
443 fdec-static
444 Fortran Var(flag_dec_static)
445 Enable DEC-style STATIC and AUTOMATIC attributes.
447 fdefault-double-8
448 Fortran Var(flag_default_double)
449 Set the default double precision kind to an 8 byte wide type.
451 fdefault-integer-8
452 Fortran Var(flag_default_integer)
453 Set the default integer kind to an 8 byte wide type.
455 fdefault-real-8
456 Fortran Var(flag_default_real)
457 Set the default real kind to an 8 byte wide type.
459 fdollar-ok
460 Fortran Var(flag_dollar_ok)
461 Allow dollar signs in entity names.
463 fdump-core
464 Fortran Ignore
465 Does nothing. Preserved for backward compatibility.
467 fdump-fortran-original
468 Fortran Var(flag_dump_fortran_original)
469 Display the code tree after parsing.
471 fdump-fortran-optimized
472 Fortran Var(flag_dump_fortran_optimized)
473 Display the code tree after front end optimization.
475 fdump-parse-tree
476 Fortran Alias(fdump-fortran-original)
477 Display the code tree after parsing; deprecated option.
479 fexternal-blas
480 Fortran Var(flag_external_blas)
481 Specify that an external BLAS library should be used for matmul calls on large-size arrays.
483 ff2c
484 Fortran Var(flag_f2c)
485 Use f2c calling convention.
487 ffixed-form
488 Fortran RejectNegative
489 Assume that the source file is fixed form.
491 ftest-forall-temp
492 Fortran Var(flag_test_forall_temp) Init(0)
493 Force creation of temporary to test infrequently-executed forall code.
495 finteger-4-integer-8
496 Fortran RejectNegative Var(flag_integer4_kind,8)
497 Interpret any INTEGER(4) as an INTEGER(8).
499 fintrinsic-modules-path
500 Fortran RejectNegative Separate
501 Specify where to find the compiled intrinsic modules.
503 fintrinsic-modules-path=
504 Fortran RejectNegative Joined
505 Specify where to find the compiled intrinsic modules.
507 ffixed-line-length-none
508 Fortran RejectNegative Var(flag_fixed_line_length,0)
509 Allow arbitrary character line width in fixed mode.
511 ffixed-line-length-
512 Fortran RejectNegative Joined UInteger Var(flag_fixed_line_length) Init(72)
513 -ffixed-line-length-<n> Use n as character line width in fixed mode.
515 ffpe-trap=
516 Fortran RejectNegative JoinedOrMissing
517 -ffpe-trap=[...]        Stop on following floating point exceptions.
519 ffpe-summary=
520 Fortran RejectNegative JoinedOrMissing
521 -ffpe-summary=[...]     Print summary of floating point exceptions.
523 ffree-form
524 Fortran RejectNegative
525 Assume that the source file is free form.
527 ffree-line-length-none
528 Fortran RejectNegative Var(flag_free_line_length,0)
529 Allow arbitrary character line width in free mode.
531 ffree-line-length-
532 Fortran RejectNegative Joined UInteger Var(flag_free_line_length) Init(132)
533 -ffree-line-length-<n>  Use n as character line width in free mode.
535 ffrontend-optimize
536 Fortran Var(flag_frontend_optimize) Init(-1)
537 Enable front end optimization.
539 fimplicit-none
540 Fortran Var(flag_implicit_none)
541 Specify that no implicit typing is allowed, unless overridden by explicit IMPLICIT statements.
543 finit-character=
544 Fortran RejectNegative Joined UInteger
545 -finit-character=<n>    Initialize local character variables to ASCII value n.
547 finit-derived
548 Fortran Var(flag_init_derived)
549 Initialize components of derived type variables according to other init flags.
551 finit-integer=
552 Fortran RejectNegative Joined
553 -finit-integer=<n>      Initialize local integer variables to n.
555 finit-local-zero
556 Fortran
557 Initialize local variables to zero (from g77).
559 finit-logical=
560 Fortran RejectNegative Joined
561 -finit-logical=<true|false>     Initialize local logical variables.
563 finit-real=
564 Fortran RejectNegative ToLower Joined Enum(gfc_init_local_real) Var(flag_init_real) Init(GFC_INIT_REAL_OFF)
565 -finit-real=<zero|snan|nan|inf|-inf>    Initialize local real variables.
567 Enum
568 Name(gfc_init_local_real) Type(enum gfc_init_local_real) UnknownError(Unrecognized option to floating-point init value: %qs)
570 EnumValue
571 Enum(gfc_init_local_real) String(zero) Value(GFC_INIT_REAL_ZERO)
573 EnumValue
574 Enum(gfc_init_local_real) String(snan) Value(GFC_INIT_REAL_SNAN)
576 EnumValue
577 Enum(gfc_init_local_real) String(nan) Value(GFC_INIT_REAL_NAN)
579 EnumValue
580 Enum(gfc_init_local_real) String(inf) Value(GFC_INIT_REAL_INF)
582 EnumValue
583 Enum(gfc_init_local_real) String(-inf) Value(GFC_INIT_REAL_NEG_INF)
585 finline-matmul-limit=
586 Fortran RejectNegative Joined UInteger Var(flag_inline_matmul_limit) Init(-1)
587 -finline-matmul-limit=<n>       Specify the size of the largest matrix for which matmul will be inlined.
589 fmax-array-constructor=
590 Fortran RejectNegative Joined UInteger Var(flag_max_array_constructor) Init(65535)
591 -fmax-array-constructor=<n>     Maximum number of objects in an array constructor.
593 fmax-identifier-length=
594 Fortran RejectNegative Joined UInteger
595 -fmax-identifier-length=<n>     Maximum identifier length.
597 fmax-subrecord-length=
598 Fortran RejectNegative Joined UInteger Var(flag_max_subrecord_length)
599 -fmax-subrecord-length=<n>      Maximum length for subrecords.
601 fmax-stack-var-size=
602 Fortran RejectNegative Joined UInteger Var(flag_max_stack_var_size) Init(-2)
603 -fmax-stack-var-size=<n>        Size in bytes of the largest array that will be put on the stack.
605 fstack-arrays
606 Fortran Var(flag_stack_arrays) Init(-1)
607 Put all local arrays on stack.
609 fmodule-private
610 Fortran Var(flag_module_private)
611 Set default accessibility of module entities to PRIVATE.
613 fopenacc
614 Fortran LTO
615 ; Documented in C
617 fopenacc-dim=
618 Fortran LTO Joined Var(flag_openacc_dims)
619 ; Documented in C
621 fopenmp
622 Fortran LTO
623 ; Documented in C
625 fopenmp-simd
626 Fortran
627 ; Documented in C
629 fpack-derived
630 Fortran Var(flag_pack_derived)
631 Try to lay out derived types as compactly as possible.
633 fpreprocessed
634 Fortran
635 ; Documented in C
637 fprotect-parens
638 Fortran Var(flag_protect_parens) Init(-1)
639 Protect parentheses in expressions.
641 frange-check
642 Fortran Var(flag_range_check) Init(1)
643 Enable range checking during compilation.
645 freal-4-real-8
646 Fortran RejectNegative Var(flag_real4_kind,8)
647 Interpret any REAL(4) as a REAL(8).
649 freal-4-real-10
650 Fortran RejectNegative Var(flag_real4_kind,10)
651 Interpret any REAL(4) as a REAL(10).
653 freal-4-real-16
654 Fortran RejectNegative Var(flag_real4_kind,16)
655 Interpret any REAL(4) as a REAL(16).
657 freal-8-real-4
658 Fortran RejectNegative Var(flag_real8_kind,4)
659 Interpret any REAL(8) as a REAL(4).
661 freal-8-real-10
662 Fortran RejectNegative Var(flag_real8_kind,10)
663 Interpret any REAL(8) as a REAL(10).
665 freal-8-real-16
666 Fortran RejectNegative Var(flag_real8_kind,16)
667 Interpret any REAL(8) as a REAL(16).
669 frealloc-lhs
670 Fortran Var(flag_realloc_lhs) Init(-1)
671 Reallocate the LHS in assignments.
673 frecord-marker=4
674 Fortran RejectNegative Var(flag_record_marker,4)
675 Use a 4-byte record marker for unformatted files.
677 frecord-marker=8
678 Fortran RejectNegative Var(flag_record_marker,8)
679 Use an 8-byte record marker for unformatted files.
681 frecursive
682 Fortran Var(flag_recursive)
683 Allocate local variables on the stack to allow indirect recursion.
685 frepack-arrays
686 Fortran Var(flag_repack_arrays)
687 Copy array sections into a contiguous block on procedure entry.
689 fcoarray=
690 Fortran RejectNegative Joined Enum(gfc_fcoarray) Var(flag_coarray) Init(GFC_FCOARRAY_NONE)
691 -fcoarray=<none|single|lib>     Specify which coarray parallelization should be used.
693 Enum
694 Name(gfc_fcoarray) Type(enum gfc_fcoarray) UnknownError(Unrecognized option: %qs)
696 EnumValue
697 Enum(gfc_fcoarray) String(none) Value(GFC_FCOARRAY_NONE)
699 EnumValue
700 Enum(gfc_fcoarray) String(single) Value(GFC_FCOARRAY_SINGLE)
702 EnumValue
703 Enum(gfc_fcoarray) String(lib) Value(GFC_FCOARRAY_LIB)
705 fcheck=
706 Fortran RejectNegative JoinedOrMissing
707 -fcheck=[...]   Specify which runtime checks are to be performed.
709 fsecond-underscore
710 Fortran Var(flag_second_underscore) Init(-1)
711 Append a second underscore if the name already contains an underscore.
713 fshort-enums
714 Fortran Var(flag_short_enums)
715 ; Documented in C
717 fsign-zero
718 Fortran Var(flag_sign_zero) Init(1)
719 Apply negative sign to zero values.
721 funderscoring
722 Fortran Var(flag_underscoring) Init(1)
723 Append underscores to externally visible names.
725 fwhole-file
726 Fortran Ignore
727 Does nothing.  Preserved for backward compatibility.
729 fworking-directory
730 Fortran
731 ; Documented in C
733 idirafter
734 Fortran Joined Separate
735 ; Documented in C
737 imultilib
738 Fortran Joined Separate
739 ; Documented in C
741 iprefix
742 Fortran Joined Separate
743 ; Documented in C
745 iquote
746 Fortran Joined Separate
747 ; Documented in C
749 isysroot
750 Fortran Joined Separate
751 ; Documented in C
753 isystem
754 Fortran Joined Separate
755 ; Documented in C
757 nostdinc
758 Fortran
759 ; Documented in C
762 Fortran Joined Separate
763 ; Documented in common.opt
765 static-libgfortran
766 Fortran
767 Statically link the GNU Fortran helper library (libgfortran).
769 std=f2003
770 Fortran
771 Conform to the ISO Fortran 2003 standard.
773 std=f2008
774 Fortran
775 Conform to the ISO Fortran 2008 standard.
777 std=f2008ts
778 Fortran
779 Conform to the ISO Fortran 2008 standard including TS 29113.
781 std=f95
782 Fortran
783 Conform to the ISO Fortran 95 standard.
785 std=gnu
786 Fortran
787 Conform to nothing in particular.
789 std=legacy
790 Fortran
791 Accept extensions to support legacy code.
793 undef
794 Fortran
795 ; Documented in C
798 Fortran
799 ; Documented in C
801 ; This comment is to ensure we retain the blank line above.