Revision c3e82b1c7b6c358719f3d1dd5cf4871cde3446a7 authored by Raul Infante-Sainz on 19 March 2021, 17:52:08 UTC, committed by Mohammad Akhlaghi on 20 March 2021, 00:53:37 UTC
Until now, each time there was a problem in the configuration of Maneage'd
projects and debugging was necessary, we had to take the following changes:
- Run the configuration on a single thread ('-j1') to see the building of
only the problematic software.
- Disable the Zenodo check manually by commenting those parts of
'reproduce/software/shell/configure.sh'. Because the internet connection
wastes a few seconds and is thus very annoying during repeated runs!
- Manually remove the '-k' option that was passed to Make (when building
the software). With the '-k', Make keeps going with the execution of
other targets if something crashes and this usually causes confusions
during the debugging.
Doing the manual changes within the code was both very annoying and prone
to errors (forgetting to correct it!).
With this commit, the existing '--debug' option has been generalized to the
software configuration phase of Maneage also. Until now, it was only
available in the analysis phase (and would directly be passed to the 'make'
command that would run the analysis). When this option is used, and the
project is in the software configuration phase, the Zenodo check won't be
done, it will use one single thread ('-j1'), and it will stop the execution
as soon as an error occurs (Make is not run with '-k').
1 parent 1524213
README.md
Directory containing LaTeX-related files
----------------------------------------
Copyright (C) 2018-2021 Mohammad Akhlaghi <mohammad@akhlaghi.org>\
See the end of the file for license conditions.
This directory contains directories to various components the LaTeX part of
the project. In a running project, it will contain the atleast the
following sub-directories. Note that
- The `src/` directory contains the LaTeX files that are loaded into
`paper.tex`. This includes the necessary preambles, the LaTeX source
files to build tables or figures (for example with TiKZ or PGFPlots), and
etc. These files are under version-control and an integral part of the
project's source.
- The `build/` directory contains all the built products (not source!) that
are created during the analysis and are necessary for building the
paper. This includes figures, plots, images, table source contents and
etc. Note that this directory is not under version control.
- The `tikz/` directory is only relevant if some of the project's figures
are built with the LaTeX packages of TiKZ or PGFPlots. It points to the
directory containing the figures (in PDF) that were built by these tools.
Note that this directory is not under version control.
The latter two directory and its contents are not under version control, so
if you have just cloned the project or are viewing its contents on a
browser, they don't exist. They will be created after the project is
configured for the running system.
When the full project is build from scratch (building the software,
downloading necessary datasets, running the analysis and building the
paper's PDF), the latter two directories will be symbolic links to special
places under the Build directory.
However, when the distributed tarball is used to only build the PDF paper
(without doing any analysis), the latter two directories will not be
symbolic links and will contain the necessary components for the paper to
be built.
### Copyright information
This file is part of Maneage (https://maneage.org).
This file is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
This file is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with this file. If not, see <http://www.gnu.org/licenses/>.
Computing file changes ...
