winConfigure.sh fixed, yet again
README.md documentation fixed accordingly
This commit is contained in:
parent
7c04b7478f
commit
601c3b1c6b
34
README.html
34
README.html
@ -97,7 +97,9 @@ this README, from the bash command line (git-bash in windows).</p>
|
|||||||
build the program and run unit test for the first time, launch the Visual
|
build the program and run unit test for the first time, launch the Visual
|
||||||
Studio X64 native tools command prompt in the cloned directory, then:</p>
|
Studio X64 native tools command prompt in the cloned directory, then:</p>
|
||||||
<pre class="bat"><code>winConfigure.bat</code></pre>
|
<pre class="bat"><code>winConfigure.bat</code></pre>
|
||||||
<p>Should the libraries change in a subsequent <code>pull --recurse-submodules</code> you will need to run <code>winConfigure.bat</code> again.</p>
|
<p>Should the libraries change in a subsequent <code>pull</code> you will need</p>
|
||||||
|
<pre class="bat"><code>pull -f --recurse-submodules
|
||||||
|
winConfigure.bat</code></pre>
|
||||||
<p>winConfigure.bat also configures the repository you just created to use
|
<p>winConfigure.bat also configures the repository you just created to use
|
||||||
<code>.gitconfig</code> in the repository, causing git to to implement GPG signed
|
<code>.gitconfig</code> in the repository, causing git to to implement GPG signed
|
||||||
commits – because <a href="./docs/contributor_code_of_conduct.html#code-will-be-cryptographically-signed" target="_blank" title="Contributor Code of Conduct">cryptographic software is under attack</a> from NSA
|
commits – because <a href="./docs/contributor_code_of_conduct.html#code-will-be-cryptographically-signed" target="_blank" title="Contributor Code of Conduct">cryptographic software is under attack</a> from NSA
|
||||||
@ -112,21 +114,21 @@ For this to be useful you need to import the repository public key
|
|||||||
<li><code>git graph</code> to graph the commit tree</li>
|
<li><code>git graph</code> to graph the commit tree</li>
|
||||||
<li><code>git alias</code> to display the git aliases.</li>
|
<li><code>git alias</code> to display the git aliases.</li>
|
||||||
</ol>
|
</ol>
|
||||||
<div class="sourceCode" id="cb3"><pre class="sourceCode bash"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="co"># To verify that the signature on future pulls is unchanged.</span></span>
|
<div class="sourceCode" id="cb4"><pre class="sourceCode bash"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="co"># To verify that the signature on future pulls is unchanged.</span></span>
|
||||||
<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="ex">gpg</span> <span class="at">--import</span> public_key.gpg</span>
|
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="ex">gpg</span> <span class="at">--import</span> public_key.gpg</span>
|
||||||
<span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a><span class="ex">gpg</span> <span class="at">--lsign</span> 096EAE16FB8D62E75D243199BC4482E49673711C</span>
|
<span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a><span class="ex">gpg</span> <span class="at">--lsign</span> 096EAE16FB8D62E75D243199BC4482E49673711C</span>
|
||||||
<span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a><span class="co"># We ignore the Gpg Web of Trust model and instead use</span></span>
|
<span id="cb4-4"><a href="#cb4-4" aria-hidden="true" tabindex="-1"></a><span class="co"># We ignore the Gpg Web of Trust model and instead use</span></span>
|
||||||
<span id="cb3-5"><a href="#cb3-5" aria-hidden="true" tabindex="-1"></a><span class="co"># the Zooko identity model.</span></span>
|
<span id="cb4-5"><a href="#cb4-5" aria-hidden="true" tabindex="-1"></a><span class="co"># the Zooko identity model.</span></span>
|
||||||
<span id="cb3-6"><a href="#cb3-6" aria-hidden="true" tabindex="-1"></a><span class="co"># We use Gpg signatures to verify that remote repository</span></span>
|
<span id="cb4-6"><a href="#cb4-6" aria-hidden="true" tabindex="-1"></a><span class="co"># We use Gpg signatures to verify that remote repository</span></span>
|
||||||
<span id="cb3-7"><a href="#cb3-7" aria-hidden="true" tabindex="-1"></a><span class="co"># code is coming from an unchanging entity, not for</span></span>
|
<span id="cb4-7"><a href="#cb4-7" aria-hidden="true" tabindex="-1"></a><span class="co"># code is coming from an unchanging entity, not for</span></span>
|
||||||
<span id="cb3-8"><a href="#cb3-8" aria-hidden="true" tabindex="-1"></a><span class="co"># Gpg Web of Trust. Web of Trust is too complicated</span></span>
|
<span id="cb4-8"><a href="#cb4-8" aria-hidden="true" tabindex="-1"></a><span class="co"># Gpg Web of Trust. Web of Trust is too complicated</span></span>
|
||||||
<span id="cb3-9"><a href="#cb3-9" aria-hidden="true" tabindex="-1"></a><span class="co"># and too user hostile to be workable or safe.</span></span>
|
<span id="cb4-9"><a href="#cb4-9" aria-hidden="true" tabindex="-1"></a><span class="co"># and too user hostile to be workable or safe.</span></span>
|
||||||
<span id="cb3-10"><a href="#cb3-10" aria-hidden="true" tabindex="-1"></a><span class="co"># Never --sign any Gpg key related to this project. --lsign it.</span></span>
|
<span id="cb4-10"><a href="#cb4-10" aria-hidden="true" tabindex="-1"></a><span class="co"># Never --sign any Gpg key related to this project. --lsign it.</span></span>
|
||||||
<span id="cb3-11"><a href="#cb3-11" aria-hidden="true" tabindex="-1"></a><span class="co"># Never check any Gpg key related to this project against a</span></span>
|
<span id="cb4-11"><a href="#cb4-11" aria-hidden="true" tabindex="-1"></a><span class="co"># Never check any Gpg key related to this project against a</span></span>
|
||||||
<span id="cb3-12"><a href="#cb3-12" aria-hidden="true" tabindex="-1"></a><span class="co"># public gpg key repository. It should not be there.</span></span>
|
<span id="cb4-12"><a href="#cb4-12" aria-hidden="true" tabindex="-1"></a><span class="co"># public gpg key repository. It should not be there.</span></span>
|
||||||
<span id="cb3-13"><a href="#cb3-13" aria-hidden="true" tabindex="-1"></a><span class="co"># Never use any email address on a gpg key related to this project</span></span>
|
<span id="cb4-13"><a href="#cb4-13" aria-hidden="true" tabindex="-1"></a><span class="co"># Never use any email address on a gpg key related to this project</span></span>
|
||||||
<span id="cb3-14"><a href="#cb3-14" aria-hidden="true" tabindex="-1"></a><span class="co"># unless it is only used for project purposes, or a fake email,</span></span>
|
<span id="cb4-14"><a href="#cb4-14" aria-hidden="true" tabindex="-1"></a><span class="co"># unless it is only used for project purposes, or a fake email,</span></span>
|
||||||
<span id="cb3-15"><a href="#cb3-15" aria-hidden="true" tabindex="-1"></a><span class="co"># or the email of an enemy.</span></span></code></pre></div>
|
<span id="cb4-15"><a href="#cb4-15" aria-hidden="true" tabindex="-1"></a><span class="co"># or the email of an enemy.</span></span></code></pre></div>
|
||||||
<p>To build the documentation in its intended html form from the markdown
|
<p>To build the documentation in its intended html form from the markdown
|
||||||
files, execute the bash script file <code>docs/mkdocs.sh</code>, in an environment where
|
files, execute the bash script file <code>docs/mkdocs.sh</code>, in an environment where
|
||||||
<code>pandoc</code> is available. On Windows, if Git Bash and Pandoc has been
|
<code>pandoc</code> is available. On Windows, if Git Bash and Pandoc has been
|
||||||
|
@ -25,7 +25,12 @@ Studio X64 native tools command prompt in the cloned directory, then:
|
|||||||
winConfigure.bat
|
winConfigure.bat
|
||||||
```
|
```
|
||||||
|
|
||||||
Should the libraries change in a subsequent `pull --recurse-submodules ` you will need to run `winConfigure.bat` again.
|
Should the libraries change in a subsequent `pull ` you will need
|
||||||
|
|
||||||
|
```bat
|
||||||
|
pull -f --recurse-submodules
|
||||||
|
winConfigure.bat
|
||||||
|
```
|
||||||
|
|
||||||
[cryptographic software is under attack]:./docs/contributor_code_of_conduct.html#code-will-be-cryptographically-signed
|
[cryptographic software is under attack]:./docs/contributor_code_of_conduct.html#code-will-be-cryptographically-signed
|
||||||
"Contributor Code of Conduct"
|
"Contributor Code of Conduct"
|
||||||
|
@ -3,6 +3,7 @@ set -e
|
|||||||
set -x
|
set -x
|
||||||
git submodule foreach --recursive 'git reset --hard'
|
git submodule foreach --recursive 'git reset --hard'
|
||||||
git submodule foreach --recursive 'git clean -xdf'
|
git submodule foreach --recursive 'git clean -xdf'
|
||||||
|
git submodule update --init --recursive
|
||||||
git config --local include.path ../.gitconfig
|
git config --local include.path ../.gitconfig
|
||||||
set +e
|
set +e
|
||||||
set +x
|
set +x
|
||||||
|
Loading…
Reference in New Issue
Block a user