DOC,BLD: Slight movement of docstrings

lapack-netlib/BLAS/SRC/meson.build

@@ -1,8 +1,3 @@
-# Conventions:
-# _ implies that the variables are not meant to be used outside here
-# Optionals are applied from the top-level meson_options.txt
-# They are declared at the top
-#
 # Derived from the CMakeLists.txt
 #
 # Relevant groups and variables:

lapack-netlib/meson.build

@@ -1,12 +1,14 @@
-# meson setup build --buildtype release
-# meson compile -C build
-# meson install --prefix=$HOME/.local/lapack
+add_languages('fortran', native: false)
+ff = meson.get_compiler('fortran')
+if ff.has_argument('-Wno-conversion')
+  add_project_arguments('-Wno-conversion', language: 'fortran')
+endif
 
 lapack_major_version = 3 # soversion
 lapack_minor_version = 12
 lapack_patch_version = 0
 lapack_version = f'@lapack_major_version@.@lapack_minor_version@.@lapack_patch_version@'
 
-subdir('BLAS/SRC') # Defines blas
-subdir('SRC')
-subdir('INSTALL')
+subdir('BLAS/SRC') # Defines blas and _allblas
+subdir('INSTALL') # Defines _install_aux
+subdir('SRC') # Defines lapack

meson.build

@@ -1,15 +1,20 @@
-project('OpenBLAS', ['c', 'fortran'], default_options: ['c_std=c99'])
+# Conventions:
+# _ implies that the variables are not meant to be used outside here
+# Optionals are applied from the top-level meson_options.txt
+# They are declared at the top
+# Typically derived from (in order) the CMakeLists.txt and Makefiles
+#
+# Installation:
+# meson setup build --buildtype release
+# meson compile -C build
+# meson install --prefix=$HOME/.local/lapack
+#
+# NOTE: This is still a work in progress, the Makefiles are canonical
+project('OpenBLAS', ['c'], default_options: ['c_std=c99'])
 
 # Skip the check for valid CC
 cc = meson.get_compiler('c')
 
-# Conditional?
-add_languages('fortran', native: false)
-ff = meson.get_compiler('fortran')
-if ff.has_argument('-Wno-conversion')
-  add_project_arguments('-Wno-conversion', language: 'fortran')
-endif
-
 # Makefile.system
 # Ignoring all the hostarch checks and conflits for arch in BSD for now
 subdir('lapack-netlib')