Skip to content

Commit e46435e

Browse files
committed
Explain changes that would be needed if using the project-prepared archive URL
Signed-off-by: tldahlgren <dahlgren1@llnl.gov>
1 parent 50dfb64 commit e46435e

1 file changed

Lines changed: 7 additions & 8 deletions

File tree

tutorial_packaging.rst

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -120,16 +120,15 @@ The areas we need to modify are highlighted in the figure below.
120120
:language: python
121121
:emphasize-lines: 5-20,27,29-30,33-35,37-40,53-54,57,61-64
122122

123-
.. note::
124-
125-
You will get a different ``sha256`` if you paste the other ``tar.gz`` URL
126-
from the repository but retention of the ``autoreconf()`` implementation
127-
should allow either to work.
123+
.. tip::
128124

129-
We generally recommend you use the project-prepared archive url instead of
130-
the ``GitHub``-generated ``Source code (tar.gz)`` url, when available,
131-
since they are less volatile in the face of GitHub shasum algorithm changes.
125+
We generally recommend you use the project-prepared archive url, when available, instead of the ``GitHub``-generated ``Source code (tar.gz)`` url since those tend to be less volatile in the face of ``GitHub`` shasum algorithm changes.
132126

127+
In this case, that would mean using the ``https://github.com/LLNL/mpileaks/releases/download/v1.0/mpileaks-1.0.tar.gz`` url.
128+
Since the file has special build customizations, the ``sha256`` is different.
129+
Key among the changes is the presence of ``autogen.sh``, which is a convenience script projects use to customize their Autotools reconfiguration process.
130+
Consequently, you would replace the more general call to ``autoreconf()`` here with an invocation of the ``autogen.sh`` script.
131+
An example of setting up and using such a script can be found in the `sos <https://github.com/spack/spack-packages/blob/develop/repos/spack_repo/builtin/packages/sos/package.py>`_ package.
133132

134133
Since we are providing a ``url``, we can `confirm the checksum <https://spack.readthedocs.io/en/latest/packaging_guide_creation.html#checksum-verification>`_, or ``sha256`` calculation.
135134
Exit your editor to return to the command line and use the `spack checksum <https://spack.readthedocs.io/en/latest/packaging_guide_creation.html#spack-checksum>`_ command:

0 commit comments

Comments
 (0)