From 2447345cb32a677a7ab0a585c7c8e980278c518b Mon Sep 17 00:00:00 2001
From: Rohit Goswami <rog32@hi.is>
Date: Sat, 2 Mar 2024 21:11:30 +0000
Subject: [PATCH] DOC,BLD: Slight movement of docstrings

---
 lapack-netlib/BLAS/SRC/meson.build |  5 -----
 lapack-netlib/meson.build          | 14 ++++++++------
 meson.build                        | 21 +++++++++++++--------
 3 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/lapack-netlib/BLAS/SRC/meson.build b/lapack-netlib/BLAS/SRC/meson.build
index b1966a4d1..82c7e19d6 100644
--- a/lapack-netlib/BLAS/SRC/meson.build
+++ b/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:
diff --git a/lapack-netlib/meson.build b/lapack-netlib/meson.build
index 1796d11be..f5a3e7f88 100644
--- a/lapack-netlib/meson.build
+++ b/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
diff --git a/meson.build b/meson.build
index f12622df3..17d6d2fa7 100644
--- a/meson.build
+++ b/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')