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

2004/gavare/index.html
+67 -100
View File
@@ -129,9 +129,9 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Anders_Gavare">Anders
Gavare</a><br> Location: <a href="../../location.html#SE">SE</a> -
<em>Kingdom of Sweden</em> (<em>Sweden</em>) <br><br></li>
<li>Name: <a href="../../authors.html#Anders_Gavare">Anders Gavare</a><br>
Location: <a href="../../location.html#SE">SE</a> - <em>Kingdom of Sweden</em> (<em>Sweden</em>)
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -141,33 +141,27 @@ Gavare</a><br> Location: <a href="../../location.html#SE">SE</a> -
<h2 id="to-build">To build:</h2>
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span></span></code></pre></div>
<p>There are three alternate versions; see <a
href="#alternate-code">alternate code</a> below for more details.</p>
<p>There are three alternate versions; see <a href="#alternate-code">alternate code</a> below
for more details.</p>
<h2 id="to-use">To use:</h2>
<div class="sourceCode" id="cb2"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./gavare</span> <span class="op">&gt;</span> ioccc_ray.ppm</span></code></pre></div>
<p>Open <code>ioccc_ray.ppm</code> with a viewer capable of viewing PPM
files. Alternatively, if you have ImageMagick installed, you can convert
it to a jpeg:</p>
<p>Open <code>ioccc_ray.ppm</code> with a viewer capable of viewing PPM files. Alternatively,
if you have ImageMagick installed, you can convert it to a jpeg:</p>
<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">convert</span> ioccc_ray.ppm ioccc_ray.jpg</span></code></pre></div>
<p>and then view <code>ioccc_ray.jpg</code> in a graphics viewer, editor
or web browser.</p>
<p>and then view <code>ioccc_ray.jpg</code> in a graphics viewer, editor or web browser.</p>
<h3 id="try">Try:</h3>
<p>If you have <code>xv(1)</code> you can do:</p>
<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">./gavare</span> <span class="kw">|</span> <span class="ex">xv</span> <span class="at">-</span></span></code></pre></div>
<p>to not worry about writing it to a file and just viewing the image it
creates.</p>
<p>to not worry about writing it to a file and just viewing the image it creates.</p>
<h2 id="alternate-code">Alternate code:</h2>
<p>The alt code <a href="gavare.alt.c">gavare.alt.c</a> allows you to
change the size of the image as well as the anti-alias setting, when
compiling.</p>
<p>The author also provided <a
href="https://gavare.se/ioccc/ioccc_gavare.c.html">on their web page for
the entry</a> an unobfuscated version that was used during development,
which we have included in the file <a
href="gavare.r3.c">gavare.r3.c</a>.</p>
<p>Finally, the file <a href="gavare.alt2.c">gavare.alt2.c</a> sets
binary mode on <code>stdout</code> which theoretically should work in
Windows.</p>
<p>The alt code <a href="gavare.alt.c">gavare.alt.c</a> allows you to change the size of the
image as well as the anti-alias setting, when compiling.</p>
<p>The author also provided <a href="https://gavare.se/ioccc/ioccc_gavare.c.html">on their web page for the
entry</a> an unobfuscated version that
was used during development, which we have included in the file
<a href="gavare.r3.c">gavare.r3.c</a>.</p>
<p>Finally, the file <a href="gavare.alt2.c">gavare.alt2.c</a> sets binary mode
on <code>stdout</code> which theoretically should work in Windows.</p>
<h3 id="alternate-build">Alternate build:</h3>
<p>To build the configurable and unobfuscated versions:</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> alt</span></code></pre></div>
@@ -175,111 +169,84 @@ Windows.</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">make</span> clobber XX=640 YY=480 alt</span></code></pre></div>
<p>You might also wish to change the anti-alias setting:</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">make</span> clobber AA=2 alt</span></code></pre></div>
<p>You may of course combine the above two commands and give any
combination you wish.</p>
<p>This is not possible with the author’s version but it is with the alt
versions (Windows - see below - and otherwise).</p>
<p>As the Windows version will not compile on most viewers’ systems we
do not build it with <code>make alt</code>; instead try:</p>
<p>You may of course combine the above two commands and give any combination you
wish.</p>
<p>This is not possible with the author’s version but it is with the alt versions
(Windows - see below - and otherwise).</p>
<p>As the Windows version will not compile on most viewers’ systems we do not build
it with <code>make alt</code>; instead 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="fu">make</span> alt2</span></code></pre></div>
<h3 id="alternate-use">Alternate use:</h3>
<p>Use <code>gavare.alt</code>, <code>gavare.r3</code> or
<code>gavare.alt2</code> as you would <code>gavare</code> above.</p>
<p>Use <code>gavare.alt</code>, <code>gavare.r3</code> or <code>gavare.alt2</code> as you would <code>gavare</code> above.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>For users of systems that distinguish between text and binary mode
(you know who you are), add a library call that specifies binary mode
for <code>stdout</code> as the first statement of <code>main()</code>,
or use <code>freopen("ioccc_ray.ppm", "wb", stdout);</code> and do not
use redirection.</p>
or use <code>freopen("ioccc_ray.ppm", "wb", stdout);</code> and do not use redirection.</p>
<p>A freely distributable command-line version of Microsoft Visual C
exhibits an optimizer bug when compiling this entry. Disable
<code>/Og</code> for best results.</p>
<p>The judges were able to figure out how to control position (in all 3
coordinates), size, and color (to some extent) of the balls.</p>
exhibits an optimizer bug when compiling this entry. Disable <code>/Og</code> for
best results.</p>
<p>The judges were able to figure out how to control position
(in all 3 coordinates), size, and color (to some extent) of the balls.</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p>It is possible to write some kinds of programs in C without using
reserved words. For very short and trivial programs, it usually isn’t
very hard to write a variant using no reserved words, but with this
program I want to show that also non-trivial programs can be written
this way. This IOCCC entry contains no reserved words (I don’t count
<code>main</code> as a reserved word, although the compiler gives it
special meaning) and no preprocessor directives.</p>
<p>This program is a small <a
href="https://en.wikipedia.org/wiki/Ray_tracing_(graphics)">ray-tracer</a>.
The first line of the source code may be modified if you want the
resulting image to be of some other resolution than the predefined. The
<code>A</code> value is an anti-alias factor. Setting it to
<code>1</code> disables the anti-aliasing feature which makes the output
look bad, but setting it too high makes the trace take a lot more time
<p>It is possible to write some kinds of programs in C without using reserved
words. For very short and trivial programs, it usually isn’t very hard to
write a variant using no reserved words, but with this program I want to
show that also non-trivial programs can be written this way. This IOCCC
entry contains no reserved words (I don’t count <code>main</code> as a reserved word,
although the compiler gives it special meaning) and no preprocessor
directives.</p>
<p>This program is a small
<a href="https://en.wikipedia.org/wiki/Ray_tracing_(graphics)">ray-tracer</a>. The first
line of the source code may be modified if you want the resulting image to be of
some other resolution than the predefined. The <code>A</code> value is an anti-alias
factor. Setting it to <code>1</code> disables the anti-aliasing feature which makes the
output look bad, but setting it too high makes the trace take a lot more time
to complete.</p>
<p>The ppm image can then be viewed using an image viewer of your own
choice. (Running the ray-tracer may take several minutes, even on fast
machines, so be patient.)</p>
<p>I am very much aware about the fact that I’m breaking the guidelines.
For example, the word <code>int</code> is a reserved word and therefore
all variable declarations are implicit. There will no doubt be
<em>lots</em> of warnings, no matter which compiler is used. Still, the
source code should be word- length-independent and
endianness-independent.</p>
<p>The ppm image can then be viewed using an image viewer of your own choice.
(Running the ray-tracer may take several minutes, even on fast machines,
so be patient.)</p>
<p>I am very much aware about the fact that I’m breaking the guidelines. For
example, the word <code>int</code> is a reserved word and therefore all variable
declarations are implicit. There will no doubt be <em>lots</em> of warnings,
no matter which compiler is used. Still, the source code should be word-
length-independent and endianness-independent.</p>
<h3 id="humor">Humor</h3>
<p>Another reason for writing code without using reserved words is that
many text editors will make all reserved words turn BOLD when printed on
<p>Another reason for writing code without using reserved words is that many
text editors will make all reserved words turn BOLD when printed on
paper. Since I care for the global environment, we shouldn’t waste any
more laser toner, or ink, than necessary. Everyone should write C code
with no reserved words, and our world will be a better place.</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>
<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-2004gavare"><a name="inventory"></a>Inventory for
2004/gavare</h1>
<h1 id="inventory-for-2004gavare"><a name="inventory"></a>Inventory for 2004/gavare</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/2004/gavare/gavare.c">gavare.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.alt.c">gavare.alt.c</a>
- alternative source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.alt2.c">gavare.alt2.c</a>
- alternate alternative source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.orig.c">gavare.orig.c</a>
- original source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.r3.c">gavare.r3.c</a>
- ray tracer used during development</li>
<li><a href="2004_gavare.tar.bz2">2004_gavare.tar.bz2</a> - download
entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.c">gavare.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.alt.c">gavare.alt.c</a> - alternative source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.alt2.c">gavare.alt2.c</a> - alternate alternative source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.orig.c">gavare.orig.c</a> - original source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/gavare.r3.c">gavare.r3.c</a> - ray tracer used during development</li>
<li><a href="2004_gavare.tar.bz2">2004_gavare.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/2004/gavare/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/.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/2004/gavare/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/.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/2004/gavare/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2004/gavare/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->