13 files changed, 91 insertions, 47 deletions
diff --git a/reproduce/analysis/bash/download-multi-try b/reproduce/analysis/bash/download-multi-try.sh
index d7e9be2..bea88d5 100755
--- a/reproduce/analysis/bash/download-multi-try
+++ b/reproduce/analysis/bash/download-multi-try.sh
@@ -1,14 +1,19 @@
-#!/bin/sh
+#!/usr/bin/env sh
 #
 # Attempt downloading multiple times before crashing whole project. From
 # the top project directory (for the shebang above), this script must be
 # run like this:
 #
-#   $ /path/to/download-multi-try downloader lockfile input-url downloaded-name
+#   $ $SHELL /path/to/download-multi-try.sh downloader lockfile \
+#                                           input-url downloaded-name
 #
-# NOTE: The 'downloader' must contain the option to specify the output name
-# in its end. For example "wget -O". Any other option can also be placed in
-# the middle.
+# NOTE:
+# - This script doesn't have a Shebang because in different stages it
+#   should be built with different shells ('/bin/sh' before Maneage
+#   installs its own shell and afterwards with Maneage's own shell).
+# - The 'downloader' must contain the option to specify the output name
+#   in its end. For example "wget -O". Any other option can also be placed in
+#   the middle.
 #
 # Due to temporary network problems, a download may fail suddenly, but
 # succeed in a second try a few seconds later. Without this script that
@@ -26,7 +31,7 @@
 # reason, you don't want to use a lock file, set the 'lockfile' name to
 # 'nolock'.
 #
-# Copyright (C) 2019-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2019-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
diff --git a/reproduce/analysis/config/INPUTS.conf b/reproduce/analysis/config/INPUTS.conf
index 1090e44..5860806 100644
--- a/reproduce/analysis/config/INPUTS.conf
+++ b/reproduce/analysis/config/INPUTS.conf
@@ -70,9 +70,10 @@
 #                   file). Don't use this if you give the 'fitsdatasum'
 #                   keyvalue.
 #
-#   INPUT-%-fitsdatasum: The FITS standard DATASUM value for HDU number 1
-#                        of the FITS file (counting from 0). Don't use this
-#                        if you give the 'sha256' keyword.
+#   INPUT-%-fitsdatasum: The FITS standard DATASUM value for the HDU given
+#                        to '-fitshdu' (below) of the FITS file (counting
+#                        from 0). Don't use this if you give the 'sha256'
+#                        keyword.
 #
 #   INPUT-%-fitshdu: The HDU identifier (counter from 0, or name) to use
 #                    for the verification. This is only relevant in the
@@ -104,7 +105,7 @@
 # also called '%' (if your local copy of the input dataset and the only
 # repository names are the same, be sure to set '%' accordingly).
 #
-# Copyright (C) 2018-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2018-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # Copying and distribution of this file, with or without modification, are
 # permitted in any medium without royalty provided the copyright notice and
diff --git a/reproduce/analysis/config/delete-me-squared-num.conf b/reproduce/analysis/config/delete-me-squared-num.conf
index c2fa79c..ba8c960 100644
--- a/reproduce/analysis/config/delete-me-squared-num.conf
+++ b/reproduce/analysis/config/delete-me-squared-num.conf
@@ -1,6 +1,6 @@
 # Number of samples in the demonstration analysis (to be deleted).
 #
-# Copyright (C) 2019-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2019-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # Copying and distribution of this file, with or without modification, are
 # permitted in any medium without royalty provided the copyright notice and
diff --git a/reproduce/analysis/config/metadata.conf b/reproduce/analysis/config/metadata.conf
index 7bafc4b..1ab7de1 100644
--- a/reproduce/analysis/config/metadata.conf
+++ b/reproduce/analysis/config/metadata.conf
@@ -15,7 +15,7 @@
 # and the copyright license name and standard link to the fully copyright
 # license.
 #
-# Copyright (C) 2020-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2020-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # Copying and distribution of this file, with or without modification, are
 # permitted in any medium without royalty provided the copyright notice and
diff --git a/reproduce/analysis/config/pdf-build.conf b/reproduce/analysis/config/pdf-build.conf
index 2aa2e9a..7821306 100644
--- a/reproduce/analysis/config/pdf-build.conf
+++ b/reproduce/analysis/config/pdf-build.conf
@@ -12,7 +12,7 @@
 # LaTeX. Otherwise, a notice will just printed that, no PDF will be
 # created.
 #
-# Copyright (C) 2018-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2018-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # Copying and distribution of this file, with or without modification, are
 # permitted in any medium without royalty provided the copyright notice and
diff --git a/reproduce/analysis/config/verify-outputs.conf b/reproduce/analysis/config/verify-outputs.conf
index db7751d..031085d 100644
--- a/reproduce/analysis/config/verify-outputs.conf
+++ b/reproduce/analysis/config/verify-outputs.conf
@@ -1,6 +1,6 @@
 # To enable verification of output datasets set this variable to 'yes'.
 #
-# Copyright (C) 2019-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2019-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # Copying and distribution of this file, with or without modification, are
 # permitted in any medium without royalty provided the copyright notice and
diff --git a/reproduce/analysis/make/delete-me.mk b/reproduce/analysis/make/delete-me.mk
index 325280d..a20abc6 100644
--- a/reproduce/analysis/make/delete-me.mk
+++ b/reproduce/analysis/make/delete-me.mk
@@ -1,6 +1,6 @@
 # Dummy Makefile to create a random dataset for plotting.
 #
-# Copyright (C) 2018-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2018-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
diff --git a/reproduce/analysis/make/initialize.mk b/reproduce/analysis/make/initialize.mk
index 9e8db4a..1f2158a 100644
--- a/reproduce/analysis/make/initialize.mk
+++ b/reproduce/analysis/make/initialize.mk
@@ -1,6 +1,6 @@
 # Project initialization.
 #
-# Copyright (C) 2018-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2018-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -41,7 +41,7 @@ bsdir=$(BDIR)/software
 # Derived directories (the locks directory can be shared with software
 # which already has this directory.).
 texdir      = $(badir)/tex
-lockdir     = $(bsdir)/locks
+lockdir     = $(badir)/.locks
 indir       = $(badir)/inputs
 prepdir     = $(badir)/prepare
 mtexdir     = $(texdir)/macros
@@ -73,7 +73,7 @@ pconfdir    = reproduce/analysis/config
 ifeq (x$(project-phase),xprepare)
 $(prepdir):; mkdir $@
 else
--include $(bsdir)/preparation-done.mk
+-include $(badir)/preparation-done.mk
 ifeq (x$(include-prepare-results),xyes)
 -include $(prepdir)/*.mk $(prepdir)/*.conf
 endif
@@ -265,16 +265,8 @@ clean:
 #	executing 'build'.
 	rm -f *.aux *.log *.synctex *.auxlock *.dvi *.out *.run.xml *.bcf
 
-#	Delete all the built outputs except the dependency programs. We'll
-#	use Bash's extended options builtin ('shopt') to enable "extended
-#	glob" (for listing of files). It allows extended features like
-#	ignoring the listing of a file with '!()' that we are using
-#	afterwards.
-	shopt -s extglob
-	rm -rf $(texdir)/macros/!(dependencies.tex|dependencies-bib.tex|hardware-parameters.tex)
-	rm -rf $(badir)/!(tex) $(texdir)/!(macros|$(texbtopdir))
-	rm -rf $(texdir)/build/!(tikz) $(texdir)/build/tikz/*
-	rm -rf $(bsdir)/preparation-done.mk
+#	Delete the full 'badir' (containing all analysis outputs).
+	rm -rf $(badir)
 
 distclean: clean
 #	Without cleaning the Git hooks, we won't be able to easily commit
@@ -285,7 +277,7 @@ distclean: clean
 #	'rm' program. So for this recipe, we'll use the host system's 'rm',
 #	not our own.
 	$$sys_rm -rf $(BDIR)
-	$$sys_rm -f .local .build $(pconfdir)/LOCAL.conf
+	$$sys_rm -f .local .build
 
 
 
@@ -469,7 +461,7 @@ dist-software:
 # process with a file and make sure that only one downloading event is in
 # progress at every moment.
 $(indir):; mkdir $@
-downloadwrapper = $(bashdir)/download-multi-try
+downloadwrapper = $(bashdir)/download-multi-try.sh
 inputdatasets := $(foreach i, \
                    $(patsubst INPUT-%-sha256,%, \
                      $(filter INPUT-%-sha256,$(.VARIABLES))) \
@@ -521,7 +513,10 @@ $(inputdatasets): $(indir)/%: | $(indir) $(lockdir)
 
 #	    Unrecognized format.
 	    *)
-	    echo "Maneage: 'DATABASEAUTHTYPE' format not recognized! Please see the description of this variable in 'reproduce/software/config/LOCAL.conf' for the acceptable values."; exit 1;;
+	    printf "Maneage: 'DATABASEAUTHTYPE' format not recognized! "
+	    printf "Please see the description of this variable in "
+	    printf "'$(bsdir)/config/LOCAL.conf' for the acceptable "
+	    printf "values."; exit 1;;
 	  esac
 	fi
 
@@ -672,7 +667,7 @@ print-general-metadata = \
 # for the final PDF. Since these are not version controlled, it must be
 # calculated everytime the project is run. So even though this file
 # actually exists, it is also aded as a '.PHONY' target above.
-$(mtexdir)/initialize.tex: | $(mtexdir)
+$(mtexdir)/initialize.tex:
 
 #	Version and title of project. About the starting '@': since these
 #	commands are run every time with './project make', it is annoying
diff --git a/reproduce/analysis/make/paper.mk b/reproduce/analysis/make/paper.mk
index 791108b..b1b794c 100644
--- a/reproduce/analysis/make/paper.mk
+++ b/reproduce/analysis/make/paper.mk
@@ -1,6 +1,6 @@
 # Build the final PDF paper/report.
 #
-# Copyright (C) 2018-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2018-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -18,6 +18,7 @@
 
 
 
+
 # LaTeX macros for paper
 # ----------------------
 #
@@ -92,6 +93,38 @@ $(mtexdir)/project.tex: $(mtexdir)/verify.tex
 
 
 
+# TeX build directory
+# -------------------
+#
+# If built in a group scenario, the TeX build directory must be separate
+# for each member (so they can work on their relevant parts of the paper
+# without conflicting with each other).
+ifeq ($(strip $(maneage_group_name)),)
+texbdir:=$(texdir)/build
+else
+texbdir:=$(texdir)/build-$(shell whoami)
+endif
+tikzdir:=$(texbdir)/tikz
+
+
+
+
+
+# Software info in TeX
+# --------------------
+#
+# The information of the installed software is placed in the
+# '.build/software' directory (which the TeX build should not depend
+# on). Therefore, we should copy those macros here in the LaTeX build
+# directory, so the TeX directory is completely independent from each
+# other.
+$(mtexdir)/dependencies.tex: $(bsdir)/config/dependencies.tex
+	cp $(bsdir)/config/*.tex $(mtexdir)/
+
+
+
+
+
 # The bibliography
 # ----------------
 #
@@ -104,8 +137,9 @@ $(mtexdir)/project.tex: $(mtexdir)/verify.tex
 # recipe and the 'paper.pdf' recipe. But if 'tex/src/references.tex' hasn't
 # been modified, we don't want to re-build the bibliography, only the final
 # PDF.
-$(texbdir)/paper.bbl: tex/src/references.tex $(mtexdir)/dependencies-bib.tex \
+$(texbdir)/paper.bbl: tex/src/references.tex $(mtexdir)/dependencies.tex \
                       | $(mtexdir)/project.tex
+
 #	If '$(mtexdir)/project.tex' is empty, don't build PDF.
 	@macros=$$(cat $(mtexdir)/project.tex)
 	if [ x"$$macros" != x ]; then
@@ -128,9 +162,13 @@ $(texbdir)/paper.bbl: tex/src/references.tex $(mtexdir)/dependencies-bib.tex \
 #	  use PGFPlots, then you should remove the '-shell-escape' option
 #	  for better security. See https://savannah.nongnu.org/task/?15694
 #	  for details.
+#
+#	  We need the modification to 'LD_LIBRARY_PATH' because we do not
+#	  build LaTeX from source and it uses '/bin/sh' (among other
+#	  possible system-wide things).
+	  export LD_LIBRARY_PATH="$(sys_library_sh_path):$$LD_LIBRARY_PATH"
 	  pdflatex -shell-escape -halt-on-error "$$p"/paper.tex
 	  biber paper
-
 	fi
 
 
@@ -158,6 +196,11 @@ paper.pdf: $(mtexdir)/project.tex paper.tex $(texbdir)/paper.bbl
 
 #	  See above for a warning and brief discussion on the the pdflatex
 #	  option '-shell-escape'.
+#
+#	  We need the modification to 'LD_LIBRARY_PATH' because we do not
+#	  build LaTeX from source and it uses '/bin/sh' (among other
+#	  possible system-wide things).
+	  export LD_LIBRARY_PATH="$(sys_library_sh_path):$$LD_LIBRARY_PATH"
 	  pdflatex -shell-escape -halt-on-error "$$p"/paper.tex
 
 #	  Come back to the top project directory and copy the built PDF
diff --git a/reproduce/analysis/make/prepare.mk b/reproduce/analysis/make/prepare.mk
index 36f5294..ffb2a3c 100644
--- a/reproduce/analysis/make/prepare.mk
+++ b/reproduce/analysis/make/prepare.mk
@@ -1,6 +1,6 @@
 # Basic preparations, called by './project make'.
 #
-# Copyright (C) 2019-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2019-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -25,7 +25,7 @@
 #
 # We need to remove the 'prepare' word from the list of 'makesrc'.
 prepare-dep = $(filter-out prepare, $(makesrc))
-$(bsdir)/preparation-done.mk: \
+$(badir)/preparation-done.mk: \
                 $(foreach s, $(prepare-dep), $(mtexdir)/$(s).tex)
 
 #	If you need to add preparations (mainly automatically generated
diff --git a/reproduce/analysis/make/top-make.mk b/reproduce/analysis/make/top-make.mk
index 460433b..e87aed8 100644
--- a/reproduce/analysis/make/top-make.mk
+++ b/reproduce/analysis/make/top-make.mk
@@ -1,6 +1,6 @@
 # Top-level Makefile (first to be loaded).
 #
-# Copyright (C) 2018-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2018-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -19,9 +19,9 @@
 
 
 
-# Load the local configuration (created after running
-# './project configure').
-include reproduce/software/config/LOCAL.conf
+# Load the local configuration (created after running './project
+# configure').
+include .build/software/config/LOCAL.conf
 
 
 
diff --git a/reproduce/analysis/make/top-prepare.mk b/reproduce/analysis/make/top-prepare.mk
index 930c2a9..d2d1c14 100644
--- a/reproduce/analysis/make/top-prepare.mk
+++ b/reproduce/analysis/make/top-prepare.mk
@@ -4,7 +4,7 @@
 # are not included here. Please see that file for thorough comments on each
 # step.
 #
-# Copyright (C) 2019-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2019-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -23,9 +23,9 @@
 
 
 
-# Load the local configuration (created after running
-# './project configure').
-include reproduce/software/config/LOCAL.conf
+# Load the local configuration (created after running './project
+# configure').
+include .build/software/config/LOCAL.conf
 
 
 
@@ -36,7 +36,7 @@ include reproduce/software/config/LOCAL.conf
 #
 # See 'top-make.mk' for complete explanation.
 ifeq (x$(maneage_group_name),x$(GROUP-NAME))
-all: $(BDIR)/software/preparation-done.mk
+all: $(BDIR)/analysis/preparation-done.mk
 	@echo "Project preparation is complete.";
 else
 all:
diff --git a/reproduce/analysis/make/verify.mk b/reproduce/analysis/make/verify.mk
index aa026b5..c74f8ca 100644
--- a/reproduce/analysis/make/verify.mk
+++ b/reproduce/analysis/make/verify.mk
@@ -1,6 +1,6 @@
 # Verify the project outputs before building the paper.
 #
-# Copyright (C) 2020-2023 Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Copyright (C) 2020-2025 Mohammad Akhlaghi <mohammad@akhlaghi.org>
 #
 # This Makefile is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by