Fix formatting differences and omissions in make.inc.*

Adds LAPACKE_WITH_TMG to make.inc.example, adds BUILD_DEPRECATED to
everything in the INSTALL dir.

Sort the variables by programs and their flags, then build options, then
library names.

1 files changed, 56 insertions, 52 deletions

diff --git a/make.inc.example b/make.inc.example
index 7f66018e..77de24a8 100644
--- a/make.inc.example
+++ b/make.inc.example
@@ -3,73 +3,77 @@
 #  LAPACK, Version 3.7.0                                           #
 #  December 2016                                                   #
 ####################################################################
-#
+
 SHELL = /bin/sh
+
+#  CC is the C compiler, normally invoked with options CFLAGS.
 #
-#  Modify the FORTRAN and OPTS definitions to refer to the
-#  compiler and desired compiler options for your machine.  NOOPT
-#  refers to the compiler options desired when NO OPTIMIZATION is
-#  selected.  Define LOADER and LOADOPTS to refer to the loader and
-#  desired load options for your machine.
+CC     = gcc
+CFLAGS = -O3
+
+#  Modify the FORTRAN and OPTS definitions to refer to the compiler
+#  and desired compiler options for your machine.  NOOPT refers to
+#  the compiler options desired when NO OPTIMIZATION is selected.
 #
 #  Note: During a regular execution, LAPACK might create NaN and Inf
 #  and handle these quantities appropriately. As a consequence, one
 #  should not compile LAPACK with flags such as -ffpe-trap=overflow.
 #
-FORTRAN  = gfortran
-OPTS     = -O2 -frecursive
-DRVOPTS  = $(OPTS)
-NOOPT    = -O0 -frecursive
+FORTRAN = gfortran
+OPTS    = -O2 -frecursive
+DRVOPTS = $(OPTS)
+NOOPT   = -O0 -frecursive
+
+#  Define LOADER and LOADOPTS to refer to the loader and desired
+#  load options for your machine.
+#
 LOADER   = gfortran
 LOADOPTS =
-#
-#  Comment out the following line to include deprecated routines to the
-#  LAPACK library.
+
+#  The archiver and the flag(s) to use when building an archive
+#  (library).  If your system has no ranlib, set RANLIB = echo.
+#
+ARCH      = ar
+ARCHFLAGS = cr
+RANLIB    = ranlib
+
+#  Timer for the SECOND and DSECND routines
+#
+#  Default:  SECOND and DSECND will use a call to the
+#  EXTERNAL FUNCTION ETIME
+#TIMER = EXT_ETIME
+#  For RS6K:  SECOND and DSECND will use a call to the
+#  EXTERNAL FUNCTION ETIME_
+#TIMER = EXT_ETIME_
+#  For gfortran compiler:  SECOND and DSECND will use a call to the
+#  INTERNAL FUNCTION ETIME
+TIMER = INT_ETIME
+#  If your Fortran compiler does not provide etime (like Nag Fortran
+#  Compiler, etc...) SECOND and DSECND will use a call to the
+#  INTERNAL FUNCTION CPU_TIME
+#TIMER = INT_CPU_TIME
+#  If none of these work, you can use the NONE value.
+#  In that case, SECOND and DSECND will always return 0.
+#TIMER = NONE
+
+#  Uncomment the following line to include deprecated routines in
+#  the LAPACK library.
 #
 #BUILD_DEPRECATED = Yes
+
+#  LAPACKE has the interface to some routines from tmglib.
+#  If LAPACKE_WITH_TMG is defined, add those routines to LAPACKE.
 #
-# Timer for the SECOND and DSECND routines
-#
-# Default : SECOND and DSECND will use a call to the EXTERNAL FUNCTION ETIME
-# TIMER    = EXT_ETIME
-# For RS6K : SECOND and DSECND will use a call to the EXTERNAL FUNCTION ETIME_
-# TIMER    = EXT_ETIME_
-# For gfortran compiler: SECOND and DSECND will use a call to the INTERNAL FUNCTION ETIME
-TIMER    = INT_ETIME
-# If your Fortran compiler does not provide etime (like Nag Fortran Compiler, etc...)
-# SECOND and DSECND will use a call to the INTERNAL FUNCTION CPU_TIME
-# TIMER    = INT_CPU_TIME
-# If neither of this works...you can use the NONE value... In that case, SECOND and DSECND will always return 0
-# TIMER     = NONE
-#
-#  Configuration LAPACKE: Native C interface to LAPACK
-#  To generate LAPACKE library: type 'make lapackelib'
-#  Configuration file: turned off (default)
-#  Complex types: C99 (default)
-#  Name pattern: mixed case (default)
-#  (64-bit) Data model: LP64 (default)
-#
-# CC is the C compiler, normally invoked with options CFLAGS.
-#
-CC = gcc
-CFLAGS = -O3
-#
-#  The archiver and the flag(s) to use when building archive (library)
-#  If you system has no ranlib, set RANLIB = echo.
-#
-ARCH     = ar
-ARCHFLAGS= cr
-RANLIB   = ranlib
-#
+#LAPACKE_WITH_TMG = Yes
+
 #  Location of the extended-precision BLAS (XBLAS) Fortran library
 #  used for building and testing extended-precision routines.  The
-#  relevant routines will be compiled and XBLAS will be linked only if
-#  USEXBLAS is defined.
-#
-# USEXBLAS    = Yes
-XBLASLIB     =
-# XBLASLIB    = -lxblas
+#  relevant routines will be compiled and XBLAS will be linked only
+#  if USEXBLAS is defined.
 #
+#USEXBLAS = Yes
+#XBLASLIB = -lxblas
+
 #  The location of the libraries to which you will link.  (The
 #  machine-specific, optimized BLAS library should be used whenever
 #  possible.)