Options documentation fixes.

Ensure that options lists fit cleanly inside the margins of a PDF page.
Reword description of option -ffrontend-loop-interchange so that it fits
cleanly inside the margins of a PDF page. Add options to those enabled
by -fdec.

From-SVN: r274958
This commit is contained in:
Mark Eggleston 2019-08-27 14:46:23 +00:00 committed by Mark Eggleston
parent 433f84bffa
commit f443634381
2 changed files with 36 additions and 26 deletions

View file

@ -1,3 +1,12 @@
2019-08-27 Mark Eggleston <mark.eggleston@codethink.com>
* invoke.texi: Ensure that the option lists fit within the
margins of a PDF page. Re-worded description of
'-ffrontend-loop-interchange' so that it fits with the margins
of a PDF page. Add '-fdec-include', '-fdec-blank-format-item'
and '-fdec-format-defaults' to list of options that are enabled
by '-fdec'.
2019-08-26 Thomas Koenig <tkoenig@gcc.gnu.org>
PR fortran/91390

View file

@ -120,13 +120,14 @@ by type. Explanations are in the following sections.
-fbackslash -fcray-pointer -fd-lines-as-code -fd-lines-as-comments -fdec @gol
-fdec-structure-fdec-intrinsic-ints -fdec-static -fdec-math -fdec-include @gol
-fdec-format-defaults -fdec-blank-format-item -fdefault-double-8 @gol
-fdefault-integer-8 -fdefault-real-8 -fdefault-real-10 -fdefault-real-16 @gol
-fdollar-ok -ffixed-line-length-@var{n} -ffixed-line-length-none @gol
-fpad-source -ffree-form -ffree-line-length-@var{n} -ffree-line-length-none @gol
-fimplicit-none -finteger-4-integer-8 -fmax-identifier-length @gol
-fmodule-private -ffixed-form -fno-range-check -fopenacc -fopenmp @gol
-freal-4-real-10 -freal-4-real-16 -freal-4-real-8 -freal-8-real-10 @gol
-freal-8-real-16 -freal-8-real-4 -std=@var{std} -ftest-forall-temp
-fdefault-integer-8 -fdefault-real-8 -fdefault-real-10 @gol
-fdefault-real-16 -fdollar-ok -ffixed-line-length-@var{n} @gol
-ffixed-line-length-none -fpad-source -ffree-form @gol
-ffree-line-length-@var{n} -ffree-line-length-none -fimplicit-none @gol
-finteger-4-integer-8 -fmax-identifier-length -fmodule-private @gol
-ffixed-form -fno-range-check -fopenacc -fopenmp -freal-4-real-10 @gol
-freal-4-real-16 -freal-4-real-8 -freal-8-real-10 -freal-8-real-16 @gol
-freal-8-real-4 -std=@var{std} -ftest-forall-temp
}
@item Preprocessing Options
@ -144,14 +145,15 @@ by type. Explanations are in the following sections.
@item Error and Warning Options
@xref{Error and Warning Options,,Options to request or suppress errors
and warnings}.
@gccoptlist{-Waliasing -Wall -Wampersand -Wargument-mismatch -Warray-bounds
@gccoptlist{-Waliasing -Wall -Wampersand -Wargument-mismatch -Warray-bounds @gol
-Wc-binding-type -Wcharacter-truncation -Wconversion @gol
-Wdo-subscript -Wfunction-elimination -Wimplicit-interface @gol
-Wimplicit-procedure -Wintrinsic-shadow -Wuse-without-only -Wintrinsics-std @gol
-Wline-truncation -Wno-align-commons -Wno-tabs -Wreal-q-constant @gol
-Wsurprising -Wunderflow -Wunused-parameter -Wrealloc-lhs @gol
-Wrealloc-lhs-all -Wfrontend-loop-interchange -Wtarget-lifetime @gol
-fmax-errors=@var{n} -fsyntax-only -pedantic -pedantic-errors @gol
-Wimplicit-procedure -Wintrinsic-shadow -Wuse-without-only @gol
-Wintrinsics-std -Wline-truncation -Wno-align-commons -Wno-tabs @gol
-Wreal-q-constant -Wsurprising -Wunderflow -Wunused-parameter @gol
-Wrealloc-lhs -Wrealloc-lhs-all -Wfrontend-loop-interchange @gol
-Wtarget-lifetime -fmax-errors=@var{n} -fsyntax-only -pedantic @gol
-pedantic-errors @gol
}
@item Debugging Options
@ -185,19 +187,16 @@ and warnings}.
-fbounds-check -ftail-call-workaround -ftail-call-workaround=@var{n} @gol
-fcheck-array-temporaries @gol
-fcheck=@var{<all|array-temps|bits|bounds|do|mem|pointer|recursion>} @gol
-fcoarray=@var{<none|single|lib>} -fexternal-blas -ff2c
-ffrontend-loop-interchange @gol
-ffrontend-optimize @gol
-fcoarray=@var{<none|single|lib>} -fexternal-blas -ff2c @gol
-ffrontend-loop-interchange -ffrontend-optimize @gol
-finit-character=@var{n} -finit-integer=@var{n} -finit-local-zero @gol
-finit-derived @gol
-finit-logical=@var{<true|false>}
-finit-derived -finit-logical=@var{<true|false>} @gol
-finit-real=@var{<zero|inf|-inf|nan|snan>} @gol
-finline-matmul-limit=@var{n} @gol
-fmax-array-constructor=@var{n} -fmax-stack-var-size=@var{n}
-fno-align-commons @gol
-fno-automatic -fno-protect-parens -fno-underscoring @gol
-fsecond-underscore -fpack-derived -frealloc-lhs -frecursive @gol
-frepack-arrays -fshort-enums -fstack-arrays
-finline-matmul-limit=@var{n} -fmax-array-constructor=@var{n} @gol
-fmax-stack-var-size=@var{n} -fno-align-commons -fno-automatic @gol
-fno-protect-parens -fno-underscoring -fsecond-underscore @gol
-fpack-derived -frealloc-lhs -frecursive -frepack-arrays @gol
-fshort-enums -fstack-arrays
}
@end table
@ -268,6 +267,8 @@ full documentation.
Other flags enabled by this switch are:
@option{-fdollar-ok} @option{-fcray-pointer} @option{-fdec-structure}
@option{-fdec-intrinsic-ints} @option{-fdec-static} @option{-fdec-math}
@option{-fdec-include} @option{-fdec-blank-format-item}
@option{-fdec-format-defaults}
If @option{-fd-lines-as-code}/@option{-fd-lines-as-comments} are unset, then
@option{-fdec} also sets @option{-fd-lines-as-comments}.
@ -970,8 +971,8 @@ may be problematic. This currently includes @option{-Wcompare-reals},
@opindex @code{Wfrontend-loop-interchange}
@cindex warnings, loop interchange
@cindex loop interchange, warning
Enable warning for loop interchanges performed by the
@option{-ffrontend-loop-interchange} option.
Warn when using @option{-ffrontend-loop-interchange} for performing loop
interchanges.
@item -Wimplicit-interface
@opindex @code{Wimplicit-interface}