2015-05-06 Thomas Koenig <tkoenig@gcc.gnu.org>
[official-gcc.git] / gcc / fortran / lang.opt
bloba81c4c52b943a467b9004d7bbaabfb1ced063262
1 ; Options for the Fortran 95 front end.
2 ; Copyright (C) 2003-2015 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 Wc-binding-type
213 Fortran Var(warn_c_binding_type) Warning LangEnabledBy(Fortran,Wall)
214 Warn if the type of a variable might be not interoperable with C
216 Wdate-time
217 Fortran
218 ; Documented in C
220 Wcharacter-truncation
221 Fortran Var(warn_character_truncation) Warning LangEnabledBy(Fortran,Wall)
222 Warn about truncated character expressions
224 Wcompare-reals
225 Fortran Warning Var(warn_compare_reals) LangEnabledBy(Fortran,Wextra)
226 Warn about equality comparisons involving REAL or COMPLEX expressions
228 Wconversion
229 Fortran Var(warn_conversion) Warning LangEnabledBy(Fortran,Wall)
230 ; Documented in C
232 Wconversion-extra
233 Fortran Var(warn_conversion_extra) Warning
234 Warn about most implicit conversions
236 Wextra
237 Fortran Warning
238 ; Documented in common
240 Wfunction-elimination
241 Fortran Warning Var(warn_function_elimination)
242 Warn about function call elimination
244 Wimplicit-interface
245 Fortran Warning Var(warn_implicit_interface)
246 Warn about calls with implicit interface
248 Wimplicit-procedure
249 Fortran Warning Var(warn_implicit_procedure)
250 Warn about called procedures not explicitly declared
252 Wline-truncation
253 Fortran Warning Var(warn_line_truncation) LangEnabledBy(Fortran,Wall) Init(-1)
254 Warn about truncated source lines
256 Wintrinsics-std
257 Fortran Var(warn_intrinsics_std) Warning LangEnabledBy(Fortran,Wall)
258 Warn on intrinsics not part of the selected standard
260 Wmaybe-uninitialized
261 Fortran LangEnabledBy(Fortran,Wall)
262 ; Documented in common.opt
264 Wmissing-include-dirs
265 Fortran
266 ; Documented in C/C++
268 Wuse-without-only
269 Fortran Var(warn_use_without_only) Warning
270 Warn about USE statements that have no ONLY qualifier
272 Wopenmp-simd
273 Fortran
274 ; Documented in C
276 Wpedantic
277 Fortran
278 ; Documented in common.opt
280 Wreal-q-constant
281 Fortran Warning Var(warn_real_q_constant) LangEnabledBy(Fortran,Wall)
282 Warn about real-literal-constants with 'q' exponent-letter
284 Wrealloc-lhs
285 Fortran Warning Var(warn_realloc_lhs) LangEnabledBy(Fortran,Wrealloc-lhs-all)
286 Warn when a left-hand-side array variable is reallocated
288 Wrealloc-lhs-all
289 Fortran Warning Var(warn_realloc_lhs_all)
290 Warn when a left-hand-side variable is reallocated
292 Wtarget-lifetime
293 Fortran Warning Var(warn_target_lifetime) LangEnabledBy(Fortran,Wall)
294 Warn if the pointer in a pointer assignment might outlive its target
296 Wreturn-type
297 Fortran Warning LangEnabledBy(Fortran,Wall)
298 ; Documented in C
300 Wsurprising
301 Fortran Warning Var(warn_surprising) LangEnabledBy(Fortran,Wall)
302 Warn about \"suspicious\" constructs
304 Wtabs
305 Fortran Warning Var(warn_tabs) LangEnabledBy(Fortran,Wall || Wpedantic)
306 Permit nonconforming uses of the tab character
308 Wunderflow
309 Fortran Warning Var(warn_underflow) Init(1)
310 Warn about underflow of numerical constant expressions
312 Wuninitialized
313 Fortran LangEnabledBy(Fortran,Wall)
314 ; Documented in common.opt
316 Wintrinsic-shadow
317 Fortran Warning Var(warn_intrinsic_shadow) LangEnabledBy(Fortran,Wall)
318 Warn if a user-procedure has the same name as an intrinsic
320 Wunused
321 LangEnabledBy(Fortran,Wall)
322 ; Documented in common.opt
324 Wunused-dummy-argument
325 Fortran Warning Var(warn_unused_dummy_argument) LangEnabledBy(Fortran,Wall)
326 Warn about unused dummy arguments.
328 Wzerotrip
329 Fortran Warning Var(warn_zerotrip) LangEnabledBy(Fortran,Wall)
330 Warn about zero-trip DO loops
333 Fortran Negative(nocpp)
334 Enable preprocessing
336 cpp=
337 Fortran Joined Negative(nocpp) Undocumented NoDWARFRecord
338 ; Internal option generated by specs from -cpp.
340 nocpp
341 Fortran Negative(cpp)
342 Disable preprocessing
345 Fortran Joined
346 ; Documented in common.opt
348 faggressive-function-elimination
349 Fortran Var(flag_aggressive_function_elimination)
350 Eliminate multiple function invokations also for impure functions
352 falign-commons
353 Fortran Var(flag_align_commons) Init(1)
354 Enable alignment of COMMON blocks
356 fall-intrinsics
357 Fortran RejectNegative Var(flag_all_intrinsics)
358 All intrinsics procedures are available regardless of selected standard
360 fallow-leading-underscore
361 Fortran Undocumented Var(flag_allow_leading_underscore)
362 ; For internal use only: allow the first character of symbol names to be an underscore
364 fautomatic
365 Fortran Var(flag_automatic) Init(1)
366 Do not treat local variables and COMMON blocks as if they were named in SAVE statements
368 fbackslash
369 Fortran Var(flag_backslash)
370 Specify that backslash in string introduces an escape character
372 fbacktrace
373 Fortran Var(flag_backtrace) Init(1)
374 Produce a backtrace when a runtime error is encountered
376 fblas-matmul-limit=
377 Fortran RejectNegative Joined UInteger Var(flag_blas_matmul_limit) Init(30)
378 -fblas-matmul-limit=<n> Size of the smallest matrix for which matmul will use BLAS
380 fcheck-array-temporaries
381 Fortran
382 Produce a warning at runtime if a array temporary has been created for a procedure argument
384 fconvert=
385 Fortran RejectNegative Joined Enum(gfc_convert) Var(flag_convert) Init(GFC_FLAG_CONVERT_NATIVE)
386 -fconvert=<big-endian|little-endian|native|swap> The endianness used for unformatted files.
388 Enum
389 Name(gfc_convert) Type(enum gfc_convert) UnknownError(Unrecognized option to endianess value: %qs)
391 EnumValue
392 Enum(gfc_convert) String(big-endian) Value(GFC_FLAG_CONVERT_BIG)
394 EnumValue
395 Enum(gfc_convert) String(little-endian) Value(GFC_FLAG_CONVERT_LITTLE)
397 EnumValue
398 Enum(gfc_convert) String(native) Value(GFC_FLAG_CONVERT_NATIVE)
400 EnumValue
401 Enum(gfc_convert) String(swap) Value(GFC_FLAG_CONVERT_SWAP)
403 fcray-pointer
404 Fortran Var(flag_cray_pointer)
405 Use the Cray Pointer extension
407 fd-lines-as-code
408 Fortran RejectNegative
409 Ignore 'D' in column one in fixed form
411 fd-lines-as-comments
412 Fortran RejectNegative
413 Treat lines with 'D' in column one as comments
415 fdefault-double-8
416 Fortran Var(flag_default_double)
417 Set the default double precision kind to an 8 byte wide type
419 fdefault-integer-8
420 Fortran Var(flag_default_integer)
421 Set the default integer kind to an 8 byte wide type
423 fdefault-real-8
424 Fortran Var(flag_default_real)
425 Set the default real kind to an 8 byte wide type
427 fdollar-ok
428 Fortran Var(flag_dollar_ok)
429 Allow dollar signs in entity names
431 fdump-core
432 Fortran Ignore
433 Does nothing. Preserved for backward compatibility.
435 fdump-fortran-original
436 Fortran Var(flag_dump_fortran_original)
437 Display the code tree after parsing
439 fdump-fortran-optimized
440 Fortran Var(flag_dump_fortran_optimized)
441 Display the code tree after front end optimization
443 fdump-parse-tree
444 Fortran Alias(fdump-fortran-original)
445 Display the code tree after parsing; deprecated option
447 fexternal-blas
448 Fortran Var(flag_external_blas)
449 Specify that an external BLAS library should be used for matmul calls on large-size arrays
451 ff2c
452 Fortran Var(flag_f2c)
453 Use f2c calling convention
455 ffixed-form
456 Fortran RejectNegative
457 Assume that the source file is fixed form
459 finteger-4-integer-8
460 Fortran RejectNegative Var(flag_integer4_kind,8)
461 Interpret any INTEGER(4) as an INTEGER(8)
463 fintrinsic-modules-path
464 Fortran RejectNegative Separate
465 Specify where to find the compiled intrinsic modules
467 fintrinsic-modules-path=
468 Fortran RejectNegative Joined
469 Specify where to find the compiled intrinsic modules
471 ffixed-line-length-none
472 Fortran RejectNegative Var(flag_fixed_line_length,0)
473 Allow arbitrary character line width in fixed mode
475 ffixed-line-length-
476 Fortran RejectNegative Joined UInteger Var(flag_fixed_line_length) Init(72)
477 -ffixed-line-length-<n> Use n as character line width in fixed mode
479 ffpe-trap=
480 Fortran RejectNegative JoinedOrMissing
481 -ffpe-trap=[...]        Stop on following floating point exceptions
483 ffpe-summary=
484 Fortran RejectNegative JoinedOrMissing
485 -ffpe-summary=[...]     Print summary of floating point exceptions
487 ffree-form
488 Fortran RejectNegative
489 Assume that the source file is free form
491 ffree-line-length-none
492 Fortran RejectNegative Var(flag_free_line_length,0)
493 Allow arbitrary character line width in free mode
495 ffree-line-length-
496 Fortran RejectNegative Joined UInteger Var(flag_free_line_length) Init(132)
497 -ffree-line-length-<n>  Use n as character line width in free mode
499 ffrontend-optimize
500 Fortran Var(flag_frontend_optimize) Init(-1)
501 Enable front end optimization
503 fimplicit-none
504 Fortran Var(flag_implicit_none)
505 Specify that no implicit typing is allowed, unless overridden by explicit IMPLICIT statements
507 finit-character=
508 Fortran RejectNegative Joined UInteger
509 -finit-character=<n>    Initialize local character variables to ASCII value n
511 finit-integer=
512 Fortran RejectNegative Joined
513 -finit-integer=<n>      Initialize local integer variables to n
515 finit-local-zero
516 Fortran
517 Initialize local variables to zero (from g77)
519 finit-logical=
520 Fortran RejectNegative Joined
521 -finit-logical=<true|false>     Initialize local logical variables
523 finit-real=
524 Fortran RejectNegative ToLower Joined Enum(gfc_init_local_real) Var(flag_init_real) Init(GFC_INIT_REAL_OFF)
525 -finit-real=<zero|snan|nan|inf|-inf>    Initialize local real variables
527 Enum
528 Name(gfc_init_local_real) Type(enum gfc_init_local_real) UnknownError(Unrecognized option to floating-point init value: %qs)
530 EnumValue
531 Enum(gfc_init_local_real) String(zero) Value(GFC_INIT_REAL_ZERO)
533 EnumValue
534 Enum(gfc_init_local_real) String(snan) Value(GFC_INIT_REAL_SNAN)
536 EnumValue
537 Enum(gfc_init_local_real) String(nan) Value(GFC_INIT_REAL_NAN)
539 EnumValue
540 Enum(gfc_init_local_real) String(inf) Value(GFC_INIT_REAL_INF)
542 EnumValue
543 Enum(gfc_init_local_real) String(-inf) Value(GFC_INIT_REAL_NEG_INF)
545 finline-matmul-limit=
546 Fortran RejectNegative Joined UInteger Var(flag_inline_matmul_limit) Init(-1)
547 -finline-matmul-limit=<n>       Specify the size of the largest matrix for which matmul will be inlined
549 fmax-array-constructor=
550 Fortran RejectNegative Joined UInteger Var(flag_max_array_constructor) Init(65535)
551 -fmax-array-constructor=<n>     Maximum number of objects in an array constructor
553 fmax-identifier-length=
554 Fortran RejectNegative Joined UInteger
555 -fmax-identifier-length=<n>     Maximum identifier length
557 fmax-subrecord-length=
558 Fortran RejectNegative Joined UInteger Var(flag_max_subrecord_length)
559 -fmax-subrecord-length=<n>      Maximum length for subrecords
561 fmax-stack-var-size=
562 Fortran RejectNegative Joined UInteger Var(flag_max_stack_var_size) Init(-2)
563 -fmax-stack-var-size=<n>        Size in bytes of the largest array that will be put on the stack
565 fstack-arrays
566 Fortran Var(flag_stack_arrays) Init(-1)
567 Put all local arrays on stack.
569 fmodule-private
570 Fortran Var(flag_module_private)
571 Set default accessibility of module entities to PRIVATE.
573 fopenacc
574 Fortran LTO
575 ; Documented in C
577 fopenmp
578 Fortran LTO
579 ; Documented in C
581 fopenmp-simd
582 Fortran
583 ; Documented in C
585 fpack-derived
586 Fortran Var(flag_pack_derived)
587 Try to lay out derived types as compactly as possible
589 fpreprocessed
590 Fortran
591 ; Documented in C
593 fprotect-parens
594 Fortran Var(flag_protect_parens) Init(-1)
595 Protect parentheses in expressions
597 frange-check
598 Fortran Var(flag_range_check) Init(1)
599 Enable range checking during compilation
601 freal-4-real-8
602 Fortran RejectNegative Var(flag_real4_kind,8)
603 Interpret any REAL(4) as a REAL(8)
605 freal-4-real-10
606 Fortran RejectNegative Var(flag_real4_kind,10)
607 Interpret any REAL(4) as a REAL(10)
609 freal-4-real-16
610 Fortran RejectNegative Var(flag_real4_kind,16)
611 Interpret any REAL(4) as a REAL(16)
613 freal-8-real-4
614 Fortran RejectNegative Var(flag_real8_kind,4)
615 Interpret any REAL(8) as a REAL(4)
617 freal-8-real-10
618 Fortran RejectNegative Var(flag_real8_kind,10)
619 Interpret any REAL(8) as a REAL(10)
621 freal-8-real-16
622 Fortran RejectNegative Var(flag_real8_kind,16)
623 Interpret any REAL(8) as a REAL(16)
625 frealloc-lhs
626 Fortran Var(flag_realloc_lhs) Init(-1)
627 Reallocate the LHS in assignments
629 frecord-marker=4
630 Fortran RejectNegative Var(flag_record_marker,4)
631 Use a 4-byte record marker for unformatted files
633 frecord-marker=8
634 Fortran RejectNegative Var(flag_record_marker,8)
635 Use an 8-byte record marker for unformatted files
637 frecursive
638 Fortran Var(flag_recursive)
639 Allocate local variables on the stack to allow indirect recursion
641 frepack-arrays
642 Fortran Var(flag_repack_arrays)
643 Copy array sections into a contiguous block on procedure entry
645 fcoarray=
646 Fortran RejectNegative Joined Enum(gfc_fcoarray) Var(flag_coarray) Init(GFC_FCOARRAY_NONE)
647 -fcoarray=<none|single|lib>     Specify which coarray parallelization should be used
649 Enum
650 Name(gfc_fcoarray) Type(enum gfc_fcoarray) UnknownError(Unrecognized option: %qs)
652 EnumValue
653 Enum(gfc_fcoarray) String(none) Value(GFC_FCOARRAY_NONE)
655 EnumValue
656 Enum(gfc_fcoarray) String(single) Value(GFC_FCOARRAY_SINGLE)
658 EnumValue
659 Enum(gfc_fcoarray) String(lib) Value(GFC_FCOARRAY_LIB)
661 fcheck=
662 Fortran RejectNegative JoinedOrMissing
663 -fcheck=[...]   Specify which runtime checks are to be performed
665 fsecond-underscore
666 Fortran Var(flag_second_underscore) Init(-1)
667 Append a second underscore if the name already contains an underscore
669 fshort-enums
670 Fortran Var(flag_short_enums)
671 ; Documented in C
673 fsign-zero
674 Fortran Var(flag_sign_zero) Init(1)
675 Apply negative sign to zero values
677 funderscoring
678 Fortran Var(flag_underscoring) Init(1)
679 Append underscores to externally visible names
681 fwhole-file
682 Fortran Ignore
683 Does nothing.  Preserved for backward compatibility.
685 fworking-directory
686 Fortran
687 ; Documented in C
689 idirafter
690 Fortran Joined Separate
691 ; Documented in C
693 imultilib
694 Fortran Joined Separate
695 ; Documented in C
697 iprefix
698 Fortran Joined Separate
699 ; Documented in C
701 iquote
702 Fortran Joined Separate
703 ; Documented in C
705 isysroot
706 Fortran Joined Separate
707 ; Documented in C
709 isystem
710 Fortran Joined Separate
711 ; Documented in C
713 nostdinc
714 Fortran
715 ; Documented in C
718 Fortran Joined Separate
719 ; Documented in common.opt
721 static-libgfortran
722 Fortran
723 Statically link the GNU Fortran helper library (libgfortran)
725 std=f2003
726 Fortran
727 Conform to the ISO Fortran 2003 standard
729 std=f2008
730 Fortran
731 Conform to the ISO Fortran 2008 standard
733 std=f2008ts
734 Fortran
735 Conform to the ISO Fortran 2008 standard including TS 29113
737 std=f95
738 Fortran
739 Conform to the ISO Fortran 95 standard
741 std=gnu
742 Fortran
743 Conform to nothing in particular
745 std=legacy
746 Fortran
747 Accept extensions to support legacy code
749 undef
750 Fortran
751 ; Documented in C
754 Fortran
755 ; Documented in C
757 ; This comment is to ensure we retain the blank line above.