force use of pandoc version >= 3.1.12.2

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

No files matched your search

+73 -108
View File
@@ -129,9 +129,9 @@
<h2 id="author"><a name="author"></a>Author:</h2>
<ul>
<li>Name: <a href="../../authors.html#Anthony_C_Howe">Anthony C.
Howe</a><br> Location: <a href="../../location.html#CA">CA</a> -
<em>Canada</em> <br><br></li>
<li>Name: <a href="../../authors.html#Anthony_C_Howe">Anthony C. Howe</a><br>
Location: <a href="../../location.html#CA">CA</a> - <em>Canada</em>
<br><br></li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -141,62 +141,55 @@ Howe</a><br> Location: <a href="../../location.html#CA">CA</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> all</span></code></pre></div>
<p>There is an <a href="#alternate-code">alternate version</a> that
might feel a bit more familiar to vi(m) users.</p>
<p>There is an <a href="#alternate-code">alternate version</a> that might feel a bit more
familiar to vi(m) users.</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">./ant</span> some_file</span></code></pre></div>
<p>NOTE: the file must already exist and not specifying any arg will
make the program exit without doing anything.</p>
<p>NOTE: the file must already exist and not specifying any arg will make the
program exit without doing anything.</p>
<h2 id="try">Try:</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="fu">make</span> hill</span>
<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./ant</span> hill</span></code></pre></div>
<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="fu">make</span> mole</span>
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./ant</span> mole</span></code></pre></div>
<h2 id="alternate-code">Alternate code:</h2>
<p>This version changes the commands slightly so that to go to the first
column you should enter <code>0</code>, to go to the last column you
should enter <code>$</code>, to quit you should enter <code>q</code>, to
go back a word you should enter <code>b</code> and to go forwards a word
you should enter <code>w</code>. Also, and perhaps most useful, rather
than having to hit ctrl-L (form-feed, <code>\f</code>) to get back to
command mode you can use the usual ESC (<code>\x1b</code>).</p>
<p>These will make it slightly less unwieldy for those familiar with
vi(m); the rest was unchanged.</p>
<p>This version changes the commands slightly so that to go to the first column you
should enter <code>0</code>, to go to the last column you should enter <code>$</code>, to quit you
should enter <code>q</code>, to go back a word you should enter <code>b</code> and to go forwards a
word you should enter <code>w</code>. Also, and perhaps most useful, rather than having to
hit ctrl-L (form-feed, <code>\f</code>) to get back to command mode you can use the usual
ESC (<code>\x1b</code>).</p>
<p>These will make it slightly less unwieldy for those familiar with vi(m); the
rest was unchanged.</p>
<h3 id="alternate-build">Alternate build:</h3>
<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>
<h3 id="alternate-use">Alternate use:</h3>
<p>Use <code>ant.alt</code> as you would <code>ant</code> above with the
changes in the input keys. See the author’s remarks for the remaining
keys.</p>
<p>Use <code>ant.alt</code> as you would <code>ant</code> above with the changes in the input keys. See
the author’s remarks for the remaining keys.</p>
<h2 id="judges-remarks">Judges’ remarks:</h2>
<p>The author was kind enough to supply a list of references below, in
case you are still confused after read the source! :-)</p>
<p>BTW: you’ve most likely heard the joke that if you want a
pseudo-random string of characters you can put a user unfamiliar with
vi(m) in a vi(m) session (in insert mode) and ask them to exit. Well in
this case you’re likely to have this problem if you ARE a vi(m) user!
:-) … especially if you don’t read the information below. This means if
you’re reading this in vi(m) you’ll have to exit this like in normal
vi(m) and then try the same with <code>./ant</code> only to fail.
:-)</p>
<p>NOTE: to enter form feed you should be able to hit
<code>ctrl-L</code>. This will allow you to exit insert mode rather than
ESC like in normal vi(m). See the author’s commands section for other
commands.</p>
<p>The author was kind enough to supply a list of references below,
in case you are still confused after read the source! :-)</p>
<p>BTW: you’ve most likely heard the joke that if you want a pseudo-random string
of characters you can put a user unfamiliar with vi(m) in a vi(m) session (in
insert mode) and ask them to exit. Well in this case you’re likely to have this
problem if you ARE a vi(m) user! :-) … especially if you don’t read the
information below. This means if you’re reading this in vi(m) you’ll have to
exit this like in normal vi(m) and then try the same with <code>./ant</code> only to fail. :-)</p>
<p>NOTE: to enter form feed you should be able to hit <code>ctrl-L</code>. This will allow you
to exit insert mode rather than ESC like in normal vi(m). See the author’s
commands section for other commands.</p>
<h2 id="authors-remarks">Author’s remarks:</h2>
<p>Ant’s Editor vIOCCC91</p>
<p>Text files consists of lines of printable text or tab characters. A
line can be of arbitrary length and is delimited by either a newline or
the end of file. Carriage return is mapped to newline on input and
ignored on output. Tab stops are every eight columns. Non-printable
characters may have unpredictable results depending on the
implementation of <code>curses</code>.</p>
<p>Text files consists of lines of printable text or tab characters. A line can be
of arbitrary length and is delimited by either a newline or the end of file.
Carriage return is mapped to newline on input and ignored on output. Tab stops
are every eight columns. Non-printable characters may have unpredictable
results depending on the implementation of <code>curses</code>.</p>
<h3 id="commands">Commands</h3>
<ul>
<li>h j k l left, down, up, right cursor movement</li>
<li>H J K L word left, page down, page up, word right</li>
<li><label><input type="checkbox" />beginning and end of
line</label></li>
<li><label><input type="checkbox" />beginning and end of line</label></li>
<li>t b top and bottom of file</li>
<li>i enter insert mode, form-feed to quit</li>
<li>x delete character under the cursor</li>
@@ -210,99 +203,71 @@ line</label></li>
<li>2 missing edit filename</li>
</ul>
<h3 id="about-this-entry">About this entry</h3>
<p>The <code>BUF</code> size should be set at compile time to 32767.
This value was used because the Sozobon C compiler for the Atari ST has
16 bit ints and a limit on the size of arrays &amp; structures of 32k.
Also the WatCom C compiler for the PC also has 16 bits ints. On machines
that have 32 bit ints (most unix boxes), a larger value for
<code>BUF</code> could be used.</p>
<p>It is recommend that compact memory model be used on PC class
machines. Small memory model may work too provided <code>BUF</code> is
not too large.</p>
<p>The character constants <code>'\b'</code>, <code>'\f'</code>,
<code>'\n'</code>, <code>'\r'</code>, <code>'\t'</code> are used in
order to provide more portable code, since the compiler should handle
the translation of them into the native character set. Note that
<code>'\f'</code> (form-feed) was used to exit insert mode because
K&amp;R C had no escape constant for the escape-key.</p>
<p>My goals for this project were to learn and experiment with the
Buffer Gap Scheme [Fin80][net90], write a useful and <em>portable</em>
program, and meet the requirements of the IOCCC. I initially planned to
have a mini <code>curses</code> built-in like <a
href="../../authors.html#John_Tromp">John Tromp</a>’s <a
href="../../1989/tromp/index.html">1989/tromp</a> Tetris entry, however
this was not as portable as using a <code>curses</code> library with
<p>The <code>BUF</code> size should be set at compile time to 32767. This value was used
because the Sozobon C compiler for the Atari ST has 16 bit ints and a limit on
the size of arrays &amp; structures of 32k. Also the WatCom C compiler for the PC
also has 16 bits ints. On machines that have 32 bit ints (most unix boxes), a
larger value for <code>BUF</code> could be used.</p>
<p>It is recommend that compact memory model be used on PC class machines. Small
memory model may work too provided <code>BUF</code> is not too large.</p>
<p>The character constants <code>'\b'</code>, <code>'\f'</code>, <code>'\n'</code>, <code>'\r'</code>, <code>'\t'</code> are used in order
to provide more portable code, since the compiler should handle the translation
of them into the native character set. Note that <code>'\f'</code> (form-feed) was used to
exit insert mode because K&amp;R C had no escape constant for the escape-key.</p>
<p>My goals for this project were to learn and experiment with the Buffer Gap
Scheme [Fin80][net90], write a useful and <em>portable</em> program, and meet the
requirements of the IOCCC. I initially planned to have a mini <code>curses</code> built-in
like <a href="../../authors.html#John_Tromp">John Tromp</a>’s
<a href="../../1989/tromp/index.html">1989/tromp</a> Tetris entry,
however this was not as portable as using a <code>curses</code> library with
<code>TERMINFO</code>/<code>TERMCAP</code> support.</p>
<p>I plan to post follow-ups such as unobfuscated versions and bugs
fixes to comp.editors. Reposts of the editor.101, gap.doc, and
editor.102 can be found in the same group every so often.</p>
<p>This entry will display a file with long lines, but has trouble
scrolling the screen with long lines. Paging up and down should work
correctly, however.</p>
<p>I plan to post follow-ups such as unobfuscated versions and bugs fixes to
comp.editors. Reposts of the editor.101, gap.doc, and editor.102 can be found
in the same group every so often.</p>
<p>This entry will display a file with long lines, but has trouble scrolling the
screen with long lines. Paging up and down should work correctly, however.</p>
<h3 id="references">References:</h3>
<p>[Fin80] Craig A. Finseth, “Theory and Practice of Text Editors
or<br />
<p>[Fin80] Craig A. Finseth, “Theory and Practice of Text Editors or<br />
A Cookbook For An EMACS”, TM-165, MIT Lab. for Computer<br />
Science</p>
<p>[KeP81] Kernighan &amp; Plauger, “Software Tools in Pascal”,<br />
Addison-Wesley, 81, chapter 6</p>
<p>[Mil86] Eugene W. Myers &amp; Webb Miller, “Row-replacement
Algorithms for Screen Editors”, TR 86-19, Dept. of Computer
Science,<br />
<p>[Mil86] Eugene W. Myers &amp; Webb Miller, “Row-replacement Algorithms
for Screen Editors”, TR 86-19, Dept. of Computer Science,<br />
U. of Arizona</p>
<p>[MyM86] Eugene W. Myers &amp; Webb Miller, “A simple
row-replacement<br />
<p>[MyM86] Eugene W. Myers &amp; Webb Miller, “A simple row-replacement<br />
method”, TR 86-28, Dept. of Computer Science, U. of Arizona</p>
<p>[Mil87] Webb Miller, “A Software Tools Sampler”, Prentice Hall, 87
ISBN 0-13-822305-X, chapter 5</p>
<p>[net90] “Editor 101/102” articles from comp.editors</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-1991ant"><a name="inventory"></a>Inventory for
1991/ant</h1>
<h1 id="inventory-for-1991ant"><a name="inventory"></a>Inventory for 1991/ant</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/1991/ant/ant.c">ant.c</a>
- entry source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/Makefile">Makefile</a>
- entry Makefile</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/ant.alt.c">ant.alt.c</a>
- alternative source</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/ant.orig.c">ant.orig.c</a>
- original source</li>
<li><a href="1991_ant.tar.bz2">1991_ant.tar.bz2</a> - download entry
source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/ant.c">ant.c</a> - entry source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/Makefile">Makefile</a> - entry Makefile</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/ant.alt.c">ant.alt.c</a> - alternative source</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/ant.orig.c">ant.orig.c</a> - original source</li>
<li><a href="1991_ant.tar.bz2">1991_ant.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/1991/ant/.entry.json">.entry.json</a>
- description of entry in JSON</li>
<li><a
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/.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/1991/ant/.entry.json">.entry.json</a> - description of entry in JSON</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/.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/1991/ant/README.md">README.md</a>
- markdown source for index.html</li>
<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1991/ant/README.md">README.md</a> - markdown source for index.html</li>
</ul>
<!-- END: next line ends content generated by: bin/output-index-inventory.sh -->