mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

force use of pandoc version >= 3.1.12.2

Browse Source 
The `bin/pandoc-wrapper.sh` tool will verify that the ssytem
has a recent enough version of `pandoc(1)`.

We explain why we insist on `pandoc(1)`. version >= 3.1.12.2
in comments where the $PANDOC_MIN_VERSION is set.

Added `--wrap=preserve` as a default argument to `pandoc(1)`.
While this change will impact every HTML file generated,
we believe this will improve the ability of someone to look
at the generated HTML and correlate with the original markdown.

Changed `bin/pandoc-wrapper.sh` VERSION from "1.4.2 2024-03-17"
to "1.4.3 2024-03-18".

Performed `make www` to achieve all of the above and to generate
HTML using the new  `--wrap=preserve` `pandoc(1)` mode.
This commit is contained in:
Landon Curt Noll committed 2024-03-18 01:26:39 -07:00
1 parent 9eb7a54e9f
commit b0b212acb1
402 files changed
+37061 -55132
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2020/burton/index.html
+41 -77
View File
@@ -130,8 +130,8 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Dave_Burton">Dave Burton</a><br>
Location: <a href="../../location.html#US">US</a> - <em>United States of
America</em> (<em>United States</em>) <br><br></li>
Location: <a href="../../location.html#US">US</a> - <em>United States of America</em> (<em>United States</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -144,122 +144,86 @@ America</em> (<em>United States</em>) <br><br></li>
<h3 id="bugs-and-misfeatures">Bugs and (Mis)features:</h3>
<p>The current status of this entry is:</p>
<pre><code>STATUS: INABIAF - please **DO NOT** fix</code></pre>
<p>For more detailed information see <a
href="../../bugs.html#2020_burton">2020 burton bugs</a>.</p>
<p>For more detailed information see <a href="../../bugs.html#2020_burton">2020 burton bugs</a>.</p>
<h2 id="to-use">To use:</h2>
<div class="sourceCode" id="cb3"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./prog</span> arg ...</span></code></pre></div>
<h2 id="try">Try:</h2>
<div class="sourceCode" id="cb4"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./try.sh</span></span></code></pre></div>
<h2 id="alternate-code">Alternate code:</h2>
<p>By default, the program works for Little Endian machines. This
alternate build is for Big Endian machines (that works whether you have
LE or BE).</p>
<p>By default, the program works for Little Endian machines. This alternate build
is for Big Endian machines (that works whether you have LE or BE).</p>
<h3 id="alternate-build">Alternate build:</h3>
<p>Running <code>make</code> builds the alternate code by default.</p>
<h3 id="alternate-use">Alternate use:</h3>
<p>Use <code>prog_be</code> as you would <code>prog</code> above.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>Can you determine why this shows strange output for
<code>./prog 128 128</code> and <code>./prog 128 128 128 128</code> but
not <code>./prog 128 128 128</code>?</p>
<p>Can you determine why this shows strange output for <code>./prog 128 128</code>
and <code>./prog 128 128 128 128</code> but not <code>./prog 128 128 128</code>?</p>
<p>Can you find a pattern here?</p>
<p>What happens if you specify different numbers?</p>
<p>This tiny one-liner is a bit-twiddler’s delight! It does all of the
work without looping.</p>
<p>To understand how it works, a good place to start is to look at the
hex value that results when the two magic constants are
<code>XOR</code>ed.</p>
<p>Once you’ve figured out what happens with one set of constants, how
can choosing new constants, but using the same computation generate a
reversed result?</p>
<p>This tiny one-liner is a bit-twiddler’s delight! It does all of the work
without looping.</p>
<p>To understand how it works, a good place to start is to look at the hex
value that results when the two magic constants are <code>XOR</code>ed.</p>
<p>Once you’ve figured out what happens with one set of constants, how can
choosing new constants, but using the same computation generate a reversed
result?</p>
<p>This code may be tested by:</p>
<div class="sourceCode" id="cb5"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> test</span></code></pre></div>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p>Invoke this with a single non-negative integer less than 256, and a
useful transformation occurs.</p>
<p>Invoke this with a single non-negative integer less than 256, and a useful
transformation occurs.</p>
<h3 id="rule-2-ish">Rule 2-ish:</h3>
<p>Exporting the constants
<code>B</code>,<code>I</code>,<code>T</code>,<code>S</code> to the <a
href="Makefile">Makefile</a> allows the code to be compiled for either
LE (little-endian) or BE (big-endian) machines(!!), so they are truly
configuration parameters, not logic.</p>
<p>Exporting the constants <code>B</code>,<code>I</code>,<code>T</code>,<code>S</code> to the <a href="Makefile">Makefile</a> allows the
code to be compiled for either LE (little-endian) or BE (big-endian)
machines(!!), so they are truly configuration parameters, not logic.</p>
<h3 id="notes">Notes:</h3>
<p>One <strike>ping</strike> argument only. It will segfault on zero
arguments, and display strange results with more than one argument.</p>
<p>Small, non-negative integers only. Useful range is
<code>0 .. 511</code>, sorta, for LE; <code>0 .. 255</code> for BE.
Bonus points if you can explain why the limits work this way.</p>
<p>One <strike>ping</strike> argument only. It will segfault on zero arguments, and
display strange results with more than one argument.</p>
<p>Small, non-negative integers only. Useful range is <code>0 .. 511</code>, sorta, for LE; <code>0 .. 255</code> for BE. Bonus points if you can explain why the limits work this way.</p>
<p>ASCII character set, 64-bit <code>long long</code>s are required.</p>
<p>v,a,r,i,a,b,l,e,s_NAME the operation.</p>
<p>No loops, no branches?!?</p>
<h4 id="compilation">Compilation:</h4>
<p>Compiles cleanly under
<code>clang -Wall -Weverything -pedantic</code>, but you need to add
<code>--include stdio.h --include stdlib.h</code> for the
<code>printf(3)</code> and <code>atoi(3)</code>.</p>
<p>Compiles cleanly under <code>clang -Wall -Weverything -pedantic</code>, but you need to add
<code>--include stdio.h --include stdlib.h</code> for the <code>printf(3)</code> and <code>atoi(3)</code>.</p>
<p>On a little-endian machine:</p>
<div class="sourceCode" id="cb6"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="fu">clang</span> <span class="at">-include</span> stdio.h <span class="at">-include</span> stdlib.h <span class="at">-Wall</span> <span class="at">-Weverything</span> <span class="at">-pedantic</span> <span class="at">-DB</span><span class="op">=</span>6945503773712347754LL <span class="at">-DI</span><span class="op">=</span>5859838231191962459LL <span class="at">-DT</span><span class="op">=</span>0 <span class="at">-DS</span><span class="op">=</span>7 <span class="at">-o</span> prog prog.c</span></code></pre></div>
<p>On a big-endian machine:</p>
<div class="sourceCode" id="cb7"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="fu">clang</span> <span class="at">-include</span> stdio.h <span class="at">-include</span> stdlib.h <span class="at">-Wall</span> <span class="at">-Weverything</span> <span class="at">-pedantic</span> <span class="at">-DB</span><span class="op">=</span>7091606191627001958LL <span class="at">-DI</span><span class="op">=</span>6006468689561538903LL <span class="at">-DT</span><span class="op">=</span>1 <span class="at">-DS</span><span class="op">=</span>0 <span class="at">-o</span> prog_be prog.c</span></code></pre></div>
<p>You might be interested to compile it both ways on the same host, and
try:</p>
<p>You might be interested to compile it both ways on the same host, and try:</p>
<div class="sourceCode" id="cb8"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./prog</span> 1<span class="kw">;</span> <span class="ex">./prog_be</span> 1</span></code></pre></div>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0
License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights
Reserved. You are free to share and adapt this file under the terms of
this license:</p>
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0 License:</h2>
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved.
You are free to share and adapt this file under the terms of this license:</p>
<pre><code>Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</code></pre>
<p>For more information, see:
https://creativecommons.org/licenses/by-sa/4.0/</p>
<p>For more information, see: https://creativecommons.org/licenses/by-sa/4.0/</p>
<!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- START: this line starts content for HTML phase 22 by: bin/output-index-inventory.sh via bin/md2html.sh -->
<!-- START: this line starts content generated by: bin/output-index-inventory.sh -->
<h1 id="inventory-for-2020burton"><a name="inventory"></a>Inventory for
2020/burton</h1>
<h1 id="inventory-for-2020burton"><a name="inventory"></a>Inventory for 2020/burton</h1>
<p><a href="#top">Jump to top</a></p>
<h2 id="primary-files">Primary files</h2>
<ul>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/prog.c">prog.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/prog.orig.c">prog.orig.c</a>
- original source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/try.sh">try.sh</a>
- how to run</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/check_be.sh">check_be.sh</a>
- test suite support file</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/check_le.sh">check_le.sh</a>
- test suite support file</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/correct">correct</a>
- test suite comparison data</li>
<li><a href="2020_burton.tar.bz2">2020_burton.tar.bz2</a> - download
entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/prog.c">prog.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/prog.orig.c">prog.orig.c</a> - original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/try.sh">try.sh</a> - how to run</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/check_be.sh">check_be.sh</a> - test suite support file</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/check_le.sh">check_le.sh</a> - test suite support file</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/correct">correct</a> - test suite comparison data</li>
<li><a href="2020_burton.tar.bz2">2020_burton.tar.bz2</a> - download entry source</li>
</ul>
<h2 id="secondary-files">Secondary files</h2>
<ul>
<li><a href="index.html">index.html</a> - entry home page</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/.gitignore">.gitignore</a>
- list of files that should not be committed under git</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/.gitignore">.gitignore</a> - list of files that should not be committed under git</li>
<li><a href=".path">.path</a> - directory path from top directory</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/burton/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->