Skip to content

Commit

Permalink
clarified relationship between PMS and ebuild
Browse files Browse the repository at this point in the history
  • Loading branch information
TheChymera committed Oct 6, 2023
1 parent 49cd3d3 commit 7fdd19a
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 4 deletions.
7 changes: 4 additions & 3 deletions article/background.tex
Original file line number Diff line number Diff line change
Expand Up @@ -63,10 +63,11 @@ \subsection{Software Dependency Management}
Complexity in this sense also refers to the fact that individual software dependencies commonly come with their own software dependencies, which may in turn have further dependencies, and so on.
The resulting network of prerequisites is known as a “dependency graph”, and its resolution is commonly handled by a package manager.

The OPFVTA article in its original form relies on Portage \cite{portage} — a package manager characterized by providing integration across programming languages, source-based package installation, and wide-ranging support for neuroscience software \cite{ng}.
As such, the dependencies of the workflow are summarized in a standardized format, which is called an ebuild.
The OPFVTA article in its original form relies on Portage \cite{portage}, the package manager of the Gentoo Linux distribution.
This package manager offers integration across programming languages, source-based package installation, and wide-ranging support for neuroscience software \cite{ng}.
As such, the dependencies of the target article itself are summarized in a standardized format, which is called an ebuild — as if it were any other piece of software.
This format is analogous to the format used to specify dependencies at all further hierarchical levels in the dependency tree.
This affords a homogeneous environment for dependency resolution, as specified by the Package Manager Standard \cite{pms}.
This affords a homogeneous environment for dependency resolution, as specified by the Package Manager Standard \cite{pms}, which constitutes the authoritative reference for the ebuild format and the behaviour of the package manager given an ebuild.
Additionally, the reference article contextualizes its raw data resource as a dependency, integrating data provision in the same network as software provision.

While the top-level ebuild (i.e., the software dependency requirements of the workflow) is included in the article repository and distributed alongside it, the ebuilds tracking dependencies further down the tree are all distributed via separate repositories.
Expand Down
1 change: 0 additions & 1 deletion yoh-notes
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@ necessary to be done to original paper "setup".
- when introducing OPFVTA article doesn't provide succinct summary , e.g. at least to mentioned that it was mouse whole-brain opto-fMRI study
- when mentioning Portage -- say that it is the package distribution of Gentoo GNU/Linux.
people would know about Gentoo but not Portage
- "Package Manager Standard" here refers to ebuild ! should be made explicit
- "Errors should be fatal more often than not." -- it is just about default behavior of shell scripts... has little to do with make or anything else!

also IIRC we had a case where it was some try/except swallowing some errors... or am I dreaming?
Expand Down

0 comments on commit 7fdd19a

Please sign in to comment.