[RFA] Bug 58200 - Option fcheck is misleadingly located in option descriptions

[Steve Kargl]

On Fri, Jan 18, 2019 at 12:28:54PM +0100, Dominique d'Humières wrote:
> 
> The first step I am proposing is to change it to
> 
> 	• 2 GNU Fortran Command Options
> 		• 2.1 Option summary
> 		• 2.2 Options controlling Fortran dialect
> 		• 2.3 Enable and customize preprocessing
> 		• 2.4 Frontend optimizations
> 			from present 2.9
> 			-ffrontend-optimize
> 			-ffrontend-loop-interchange
> 			-faggressive-function-elimination
> 			-fexternal-blas
> 			-fblas-matmul-limit=n
> 			-finline-matmul-limit=n
> 		• 2.5 Options changing the kind of variables
> 			from present 2.2 and changing the order
> 			-finteger-4-integer-8
> 			-freal-*
> 			-fdefault-integer-8
> 			-fdefault-real-*
> 		• 2.6 Options to request or suppress errors and warnings
> 		• 2.7 Options for debugging your program or GNU Fortran

 			-ffpe-trap=list
 			-ffpe-summary=list

I think of these as debugging option.  I suspect most people don't
want to use these after they are debugging suspicious floating point
results.

> 		• 2.8 Options enabling runtime diagnostics
> 			from present 2.9
> 			-fcheck=<keyword>
> 			-fbounds-check
> 			-fcheck-array-temporaries
> 			from present 2.5
> 			-fno-backtrace
> 		• 2.9 Options for directory search
> 		• 2.10 Influencing the linking step
> 		• 2.11 Influencing runtime behavior

 			-finit-*
 			-frealloc-lhs (?)

-finit-* are not runtime diagnostic options.  These are crutches for lazy
programmers who cannot be bothered with properly initializing their variables.

-frealloc-lhs changes whether automatic re-allocation occurs.  It probably
belongs here as it affects runtime behavior.

> 		• 2.12 Options for code generation conventions
> 		• 2.13 Options for interoperability with other languages
> 		• 2.14 Environment variables affecting gfortran
> 
> As a second improvement, would be to rename 2.11 to something such as "Influencing I/O behavior", delete the 2.14 entry after moving its content to 2.11, and rename 2.7 to "Options for debugging GNU Fortran" and moving it to the last entry.
> 
> Waiting for comments.
> 
> Dominique
> 

-- 
Steve
20170425 https://www.youtube.com/watch?v=VWUpyCsUKR4
20161221 https://www.youtube.com/watch?v=IbCHE-hONow