commit ebb7430d1c57967242c5d5f7b910b8ae0b9241a4
parent a9af6ee92a68b5f46a2b42f8bc4ebb926db59aee
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Fri, 18 Mar 2022 16:34:41 +0100
stardis : fix the 0.13.1 publication
Diffstat:
3 files changed, 40 insertions(+), 17 deletions(-)
diff --git a/stardis/downloads/Stardis-0.13.1-GNU-Linux64.tar.gz b/stardis/downloads/Stardis-0.13.1-GNU-Linux64.tar.gz
@@ -1 +1 @@
-#$# git-wad 9421db41dfbce49ec99c140bf8db165cb787a9c9e22d5ff905a0c5c63b183b84 20552224
-\ No newline at end of file
+#$# git-wad bac5c530e3a740ed882882d767fe11da6859fb907a4724ac5d3fd38b04b1f7dd 20283909
+\ No newline at end of file
diff --git a/stardis/downloads/Stardis-0.13.1-Sources.tar.gz b/stardis/downloads/Stardis-0.13.1-Sources.tar.gz
@@ -1 +1 @@
-#$# git-wad b64abb6bd4aaa97eb70cba20a268ed7c6b72bec5ceef46d6ae1a911df32502fa 952312
-\ No newline at end of file
+#$# git-wad 9635397c333688ac6e26b4687e1ca9036479bce5bfb64e2141327aac3d2b0781 709363
+\ No newline at end of file
diff --git a/stardis/stardis.html.in b/stardis/stardis.html.in
@@ -185,7 +185,7 @@ Stardis-Solver upon the aforementioned hypothesis.</p>
Temporal dynamics analysis of a solid cube which has temperatures imposed on
its left and right sides, and has adiabatic boundaries elsewhere. The
center temperature is the result of a simple postprocess of a <b>single
- Monte-Carlo computation</b>.
+ Monte-Carlo computation</b>.
</div>
</div>
@@ -296,15 +296,27 @@ $ gpg --verify Stardis-${VERSION}-GNU-Linux64.tar.gz.sig
$ tar xzf Stardis-${VERSION}-GNU-Linux64.tar.gz
</pre>
-<p>Finally, source the provided <code>stardis.profile</code> file to register
-the Stardis installation for the current shell priorly to the invocation of the
+<p>We have now to generate the <code>stardis.profile</code> POSIX shell script
+that is going to be executed in the running shell to update its environment
+variables with the install directories of <code>stardis</code> that, once done,
+can be finally be run.</p>
+
+<p>Now we need to generate the <code>stardis.profile</code> POSIX shell script
+that we run in the running shell to update its environment variables with the
+Stardis installation directory. Once this is done, we can run the
<code>stardis</code> program.</p>
<pre class="code">
+$ sh ~/Stardis-${VERSION}-GNU-Linux64/etc/build-stardis-profile.sh
$ . ~/Stardis-${VERSION}-GNU-Linux64/etc/stardis.profile
$ stardis -h # Launch stardis
</pre>
+<p>Note that if the <code>build-stardis-profile.sh</code> script should no
+longer be run as long as the Stardis installation directory remains the same,
+the <code>stardis.profile</code> script must be run in each new POSIX shell in
+which you want to give access to the Stardis installation.</p>
+
<p>The <b>reference documentation</b> of the Stardis CLI and of its associated
tools and fileformats is located in the <code>share/man</code> sub-directory.
To consult it, simply invoke the <code>man</code> command-line.</p>
@@ -326,12 +338,9 @@ Stardis framework.</p>
<h2 id=build>Build from sources</h2>
<p>The Stardis framework can be built directly from its source tree. Note that
-it is actually the only way to enable distributed parallelism via the Message
-Passing Interface specification, precompiled version of Stardis does not
-support MPI. We point out that the whole Stardis framework was successfully
-built on Windows 10 with Visual Studio Community 2019. However, we only
-officially support GNU/Linux 64 bits and the build procedure is thus only given
-for this system.</p>
+it is actually the only way to <b>enable distributed parallelism</b> via the
+Message Passing Interface specification, precompiled version of Stardis does
+not support MPI.</p>
<p>The simplest way to build Stardis from its sources is to rely on the
<code>stardis</code> branch of the <a
@@ -370,18 +379,32 @@ procedure is summed up to:</p>
installation of the Stardis CLI tools and support for distributed parallelism
via MPI.</p>
+<p>By default Stardis is installed in the <code>local</code> subdirectory of
+<code>Stardis-${VERSION}</code>. As the last step of the installation, we need
+to generate the <code>stardis.profile</code> POSIX shell script that will be
+run in a running shell to update its environment variables with the Stardis
+installation directory.</p>
+
+<pre class="code">
+$ sh ~/Stardis-${VERSION}/local/etc/build-stardis-profile.sh
+</pre>
+
<h3>Run</h3>
-<p>By default Stardis is installed in the <code>local</code> subdirectory of
-<code>Stardis-${VERSION}</code>. Source the provided
-<code>stardis.profile</code> file to register Stardis against the current
-shell.</p>
+<p>Before running stardis, you must first run the <code>stardis.profile</code>
+script once in the current POSIX shell to update its environment variables.
+Then you can run the stardis program and check out its reference
+documentation.</p>
<pre class="code">
$ . ~/Stardis-${VERSION}/local/etc/stardis.profile
$ stardis -h
</pre>
+<p>We point out that the <code>stardis.profile</code> script must be run in
+each new POSIX shell in which you want to give access to the Stardis
+installation.</p>
+
<h3>Package</h3>
<p>Once built, the Stardis installation can be packaged in an archive that can
