[Doc] fix some stuff in quickstart & set ACPP_DEBUG_LEVEL=0 in envs (#1770)

Author: tdavidcl

doc/sphinx/source/user_guide/quickstart.md

@@ -46,7 +46,7 @@ If you get an error that's weird and it is probably simpler to drop a message on
 With Homebrew:
 
 ```bash
-brew install cmake libomp boost open-mpi adaptivecpp python ninja
+brew install cmake libomp boost open-mpi adaptivecpp python ninja fmt
 ```
 
 :::
@@ -124,14 +124,14 @@ Shamrock provides its own utilities with pre-made configurations for various mac
 :::{tab-item} Linux (Debian & Ubuntu)
 
 ```bash
-./env/new-env --builddir build --machine debian-generic.acpp -- --backend omp
+./env/new-env --machine debian-generic.acpp --builddir build -- --backend omp
 ```
 
 :::
 :::{tab-item} MacOS
 
 ```bash
-./env/new-env --builddir build --machine macos-generic.acpp -- --backend omp
+./env/new-env --machine macos-generic.acpp --builddir build --
 ```
 
 :::
@@ -345,6 +345,10 @@ You should see a figure like:
 The `--rscript` flag means run-scripts. In Shamrock since everything goes through Python your run will be a Python script, hence the name "run script". Here it is a benchmark of one of Shamrock's algorithms.
 :::
 
+:::{note}
+It is normal for the figures to vary slightly between runs. This is a benchmark of the exclusive scans implemented in Shamrock, which are quite fast and therefore subject to some run-to-run variability. On CPU, this is especially noticeable depending on what else is using the memory bandwidth.
+:::
+
 ### Python interpreter + Ipython
 
 :::::{warning}
@@ -403,6 +407,10 @@ import shamrock
 In [1]:
 ```
 
+:::{note}
+Currently on MacOS and maybe some other OS you will see `UserWarning: Attempting to work in a virtualenv. If you encounter problems, please install IPython inside the virtualenv.` do not worry to much about it, it works just fine without a venv. We will create one at the next step anyway.
+:::
+
 Now you can use the same python as one would in runscripts. A classic one to run there is the following (which is what I do in the basic CI test btw):
 
 ```{code-block} python

env/machine/archlinux/acpp/env_built_acpp.sh

@@ -55,6 +55,7 @@ export ACPP_APPDB_DIR=/tmp/acpp-appdb # otherwise it would we in the $HOME/.acpp
 export ACPP_GIT_DIR=$BUILD_DIR/.env/acpp-git
 export ACPP_BUILD_DIR=$BUILD_DIR/.env/acpp-builddir
 export ACPP_INSTALL_DIR=$BUILD_DIR/.env/acpp-installdir
+export ACPP_DEBUG_LEVEL=0
 export LLVM_INSTALL_DIR=/usr/lib/llvm20
 
 function setupcompiler {

env/machine/conda/acpp/conda_acpp_env.sh

@@ -13,7 +13,7 @@ echo " --------- Activating conda environment --------- "
 conda activate shamrock_dev_environment
 echo " ------------- Environment activated ------------ "
 
-if which ccache &> /dev/null; then
+if which ccache &>/dev/null; then
     # to debug
     #export CCACHE_DEBUG=1
     #export CCACHE_DEBUGDIR=$BUILD_DIR/ccache-debug
@@ -28,9 +28,9 @@ fi
 export CMAKE_GENERATOR="Ninja"
 export ACPP_APPDB_DIR=/tmp/acpp-appdb # otherwise it would we in the $HOME/.acpp
 
-
 #enfore the use of the correct clang++ as the installation of acpp register a buggy compiler
 export ACPP_CPU_CXX=$(which clang++)
+export ACPP_DEBUG_LEVEL=0
 
 function shamconfigure {
     cmake \

env/machine/debian-generic/acpp/env_built_acpp.sh

@@ -1,6 +1,6 @@
 # Everything before this line will be provided by the new-env script
 
-if which ccache &> /dev/null; then
+if which ccache &>/dev/null; then
     export CCACHE_CMAKE_ARG="-DCMAKE_CXX_COMPILER_LAUNCHER=ccache"
     echo " ----- ccache found, using it ----- "
 else
@@ -12,6 +12,7 @@ export ACPP_APPDB_DIR=/tmp/acpp-appdb # otherwise it would we in the $HOME/.acpp
 export ACPP_GIT_DIR=$BUILD_DIR/.env/acpp-git
 export ACPP_BUILD_DIR=$BUILD_DIR/.env/acpp-builddir
 export ACPP_INSTALL_DIR=$BUILD_DIR/.env/acpp-installdir
+export ACPP_DEBUG_LEVEL=0
 
 function setupcompiler {
     clone_acpp || return

env/machine/macos-generic/acpp/env_built_acpp.sh

@@ -1,6 +1,6 @@
 # Everything before this line will be provided by the new-env script
 
-if which ccache &> /dev/null; then
+if which ccache &>/dev/null; then
     # to debug
     #export CCACHE_DEBUG=1
     #export CCACHE_DEBUGDIR=$BUILD_DIR/ccache-debug
@@ -20,15 +20,18 @@ echo " ---------- Activating sham environment ---------- "
 for package in "${required_packages[@]}"; do
     if ! brew list --versions "$package" &>/dev/null; then
         echo "Error: $package is not installed. Please run 'brew install $package'."
-        return 1  # Abort sourcing the script and return to the current shell
+        return 1 # Abort sourcing the script and return to the current shell
     else
         echo "$package is installed."
     fi
 done
 
 echo "All required packages are installed."
 
-ACPP_ROOT=`brew list adaptivecpp | grep acpp-info | sed -E "s/\/bin\/.*//"`
+export ACPP_DEBUG_LEVEL=0
+
+ACPP_ROOT=$(brew list adaptivecpp | grep acpp-info | sed -E "s/\/bin\/.*//")
+
 echo " ------------- Environment activated ------------- "
 
 function shamconfigure {