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

Dominique d'Humières dominiq@lps.ens.fr
Fri Jan 18 11:29:00 GMT 2019


Since I have taken this PR, I did not find any simple satisfactory solution. The present section 2.9 is an aggregate of unrelated options and the closest fix I came to would be to replace "Options for code generation conventions" with "Other options for code generation".

The present organisation is

	• 2 GNU Fortran Command Options
		• 2.1 Option summary
		• 2.2 Options controlling Fortran dialect
		• 2.3 Enable and customize preprocessing
		• 2.4 Options to request or suppress errors and warnings
		• 2.5 Options for debugging your program or GNU Fortran
		• 2.6 Options for directory search
		• 2.7 Influencing the linking step
		• 2.8 Influencing runtime behavior
		• 2.9 Options for code generation conventions
		• 2.10 Options for interoperability with other languages
		• 2.11 Environment variables affecting gfortran

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
		• 2.8 Options enabling runtime diagnostics
			from present 2.9
			-fcheck=<keyword>
			-fbounds-check
			-fcheck-array-temporaries
			-finit-*
			-frealloc-lhs (?)
			from present 2.5
			-ffpe-trap=list
			-ffpe-summary=list
			-fno-backtrace
		• 2.9 Options for directory search
		• 2.10 Influencing the linking step
		• 2.11 Influencing 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



More information about the Fortran mailing list