improved indentation and whitespace for markdown code blocks

All code blocks in markdown have been intended by at least 4 spaces. We add `--tab-stop=8` to all `pandoc(1)` executions in order to set a better tab stop indentation, especially for tab intended code blocks. Changed `bin/pandoc-wrapper.sh` VERSION from "1.5.3 2024-03-26" to "1.6 2024-03-31". Fixed `1991/brnstnd/sorta.README.md` so that the sorta code is code blocks. Removed unneeded paragraph group in copyright in `inc/footer.default.html`. Fixed excess whitespace after list Author on entry `index.html` page. Changed `bin/output-index-author.sh` VERSION from "1.5.2 2024-03-26" to "1.6 2024-03-31". Performed `make www` to perform the above and test under macOS. TODO: Fix the problem of the initial line of code being extra intended. TODO: Fix excess whitespace around code that is inline.
2024-04-01 04:48:48 -07:00
1 parent b84c27ce02
commit a996f8d2b8
@@ -1,7 +1,7 @@
 ## To build:

 ```sh
-make
+    make
 ```


@@ -15,9 +15,9 @@ to reboot and rely on having a floppy drive (if you even remember what those are
 The current status of this entry is:

 ```
-STATUS: compiled executable crashes - please help us fix
-STATUS: doesn't work with some platforms - please help us fix
-STATUS: INABIAF - please **DO NOT** fix
+    STATUS: compiled executable crashes - please help us fix
+    STATUS: doesn't work with some platforms - please help us fix
+    STATUS: INABIAF - please **DO NOT** fix
 ```

 For more detailed information see [2004 gavin bugs](../../bugs.html#2004_gavin).
@@ -26,7 +26,7 @@ For more detailed information see [2004 gavin bugs](../../bugs.html#2004_gavin).
 ## To use:

 ```sh
-./gavin
+    ./gavin
 ```


@@ -37,14 +37,14 @@ those? We do!):


 ```sh
-su
+    su
 ```

 Make a floppy with an ext2 filesystem (`mke2fs /dev/fd0` replacing `fd0` with
 whatever the floppy device is!),  mount it under `/mnt/floppy` and then:

 ```sh
-cp kernel fs.tar lilo.conf boot.b /mnt/floppy
+    cp kernel fs.tar lilo.conf boot.b /mnt/floppy
 ```

 NOTE: If the version of your lilo is not 21.4, use the appropriate boot.b file.
@@ -52,27 +52,27 @@ NOTE: If the version of your lilo is not 21.4, use the appropriate boot.b file.
 NOTE: If your floppy drive is not `/dev/fd0`, edit lilo.conf appropriately.

 ```sh
-lilo -C /mnt/floppy/lilo.conf
+    lilo -C /mnt/floppy/lilo.conf
 ```

 Boot from the floppy on an x86 machine with a PS/2 keyboard and mouse.
 Move the window away from the corner.

 ```sh
-vi gavin.c
+    vi gavin.c
 ```

 Scroll up and down the file with up-arrow and down-arrow.

 ```sh
-sh
+    sh
 ```

 You can have several shell windows:

 ```sh
-vi README.md
-./prim
+    vi README.md
+    ./prim
 ```

 Press and hold any key.
@@ -87,7 +87,7 @@ you can use it with `QEMU`.
 ### Alternate build:

 ```sh
-make alt
+    make alt
 ```


@@ -198,7 +198,7 @@ so these may need updating as appropriate (`0x90200` is the address
 at which a Linux bootloader loads an x86 kernel image).

 ```
-\* ;-)
+    \* ;-)
 ```


@@ -136,24 +136,28 @@ should do no damage to your existing setup, BUT I ACCEPT NO LIABILITY FOR ANY
 DAMAGE DONE BY THIS PROGRAM. Run it at your own risk. The OS has been tested
 on half a dozen machines or so, and worked on all but one. The failure came in
 the form of the machine rebooting itself midway through loading the OS, with no
-nasty side-effects.</p>
-<p>Hardware requirements - i386 or better processor, but the GUI is
-surprisingly power-hungry, so I would recommend a fast P3 or P4 processor
-(has been tested on P3/P4/Athlon machines). Minimum RAM is something like
-32MB. PS/2 mouse &amp; keyboard required - no USB I’m afraid, and the keyboard
-map is for a UK keyboard. Uses VESA VBE 3.0, so should work on any modern
-graphics card (has been tested on NVIDIA, Matrox, and SiS cards).</p></li>
-<li><p>Now you need to setup a bootloader to load the OS. If you have a system
+nasty side-effects.</p></li>
+</ol>
+<pre><code>    Hardware requirements - i386 or better processor, but the GUI is
+    surprisingly power-hungry, so I would recommend a fast P3 or P4 processor
+    (has been tested on P3/P4/Athlon machines).  Minimum RAM is something like
+    32MB.  PS/2 mouse &amp; keyboard required - no USB I&#39;m afraid, and the keyboard
+    map is for a UK keyboard.  Uses VESA VBE 3.0, so should work on any modern
+    graphics card (has been tested on NVIDIA, Matrox, and SiS cards).</code></pre>
+<ol start="3" type="1">
+<li>Now you need to setup a bootloader to load the OS. If you have a system
 using a lilo bootloader you can simply add the OS to your boot menu. Just add
 appropriate <code>image=</code> and <code>initrd=</code> lines to your <code>/etc/lilo.conf</code>, pointing at
 <code>kernel</code> and <code>fs.tar</code> respectively (as built by make earlier), then run <code>lilo</code>.
 If you do not wish modify your lilo setup, one easy option is to get yourself a
 GRUB boot disk image, and follow the instructions for GRUB below - Debian users
-can simply run<code>apt-get install grub-disk</code> to get themselves a GRUB boot disk.</p>
-<p>If you run GRUB, then at the boot menu simply hit <code>c</code> to get a console, then
-type <code>kernel=(hd0,0)/&lt;PATH&gt;/kernel</code> (substituting appropriate hard
-drive/partition numbers &amp; path, or using <code>(fd0)</code> to load a kernel on the
-floppy), then <code>initrd=(hd0,0)/&lt;PATH&gt;/fs.tar</code>, and finally <code>boot</code>.</p></li>
+can simply run<code>apt-get install grub-disk</code> to get themselves a GRUB boot disk.</li>
+</ol>
+<pre><code>    If you run GRUB, then at the boot menu simply hit `c` to get a console, then
+    type `kernel=(hd0,0)/&lt;PATH&gt;/kernel` (substituting appropriate hard
+    drive/partition numbers &amp; path, or using `(fd0)` to load a kernel on the
+    floppy), then `initrd=(hd0,0)/&lt;PATH&gt;/fs.tar`, and finally `boot`.</code></pre>
+<ol start="4" type="1">
 <li><p>Assuming the OS has booted, what can you do now? Well, start by trying <code>sh</code>,
 to open another shell. Then, try <code>vi gavin.c</code> to open up the OS source in a
 text file viewer (up/down or PgUp/PgDn to scroll). Note that the provided
@@ -15,12 +15,14 @@ on half a dozen machines or so, and worked on all but one.  The failure came in
 the form of the machine rebooting itself midway through loading the OS, with no
 nasty side-effects.

+```
    Hardware requirements - i386 or better processor, but the GUI is
    surprisingly power-hungry, so I would recommend a fast P3 or P4 processor
    (has been tested on P3/P4/Athlon machines).  Minimum RAM is something like
    32MB.  PS/2 mouse & keyboard required - no USB I'm afraid, and the keyboard
    map is for a UK keyboard.  Uses VESA VBE 3.0, so should work on any modern
    graphics card (has been tested on NVIDIA, Matrox, and SiS cards).
+```

 3. Now you need to setup a bootloader to load the OS.  If you have a system
 using a lilo bootloader you can simply add the OS to your boot menu.  Just add
@@ -30,10 +32,12 @@ If you do not wish modify your lilo setup, one easy option is to get yourself a
 GRUB boot disk image, and follow the instructions for GRUB below - Debian users
 can simply run`apt-get install grub-disk` to get themselves a GRUB boot disk.

+```
    If you run GRUB, then at the boot menu simply hit `c` to get a console, then
    type `kernel=(hd0,0)/<PATH>/kernel` (substituting appropriate hard
    drive/partition numbers & path, or using `(fd0)` to load a kernel on the
    floppy), then `initrd=(hd0,0)/<PATH>/fs.tar`, and finally `boot`.
+```

 4. Assuming the OS has booted, what can you do now?  Well, start by trying `sh`,
 to open another shell.  Then, try `vi gavin.c` to open up the OS source in a
@@ -132,8 +132,7 @@
 <h2 id="author"><a name="author"></a>Author:</h2>
 <ul>
 <li>Name: <a href="../../authors.html#Gavin_Barraclough">Gavin Barraclough</a><br>
-Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em>
-<br><br></li>
+Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em></li>
 </ul>

 <!-- END: next line ends content generated by: bin/output-index-author.sh -->
@@ -142,42 +141,42 @@ Location: <a href="../../location.html#ZZ">ZZ</a> - <em>Unknown location</em>
 <!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->

 <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>
+<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 is an alternate version for those who wish to use QEMU rather than having
 to reboot and rely on having a floppy drive (if you even remember what those are
 :-) ) etc. See <a href="#alternate-code">alternate code</a> below.</p>
 <h3 id="bugs-and-misfeatures">Bugs and (Mis)features:</h3>
 <p>The current status of this entry is:</p>
-<pre><code>STATUS: compiled executable crashes - please help us fix
-STATUS: doesn&#39;t work with some platforms - please help us fix
-STATUS: INABIAF - please **DO NOT** fix</code></pre>
+<pre><code>    STATUS: compiled executable crashes - please help us fix
+    STATUS: doesn&#39;t work with some platforms - please help us fix
+    STATUS: INABIAF - please **DO NOT** fix</code></pre>
 <p>For more detailed information see <a href="../../bugs.html#2004_gavin">2004 gavin 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">./gavin</span></span></code></pre></div>
+<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">./gavin</span></span></code></pre></div>
 <h2 id="try">Try:</h2>
 <p>To enjoy the results (on a Linux/x86 machine) with a floppy drive (remember
 those? We 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="fu">su</span></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">su</span></span></code></pre></div>
 <p>Make a floppy with an ext2 filesystem (<code>mke2fs /dev/fd0</code> replacing <code>fd0</code> with
 whatever the floppy device is!), mount it under <code>/mnt/floppy</code> and then:</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">cp</span> kernel fs.tar lilo.conf boot.b /mnt/floppy</span></code></pre></div>
+<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">cp</span> kernel fs.tar lilo.conf boot.b /mnt/floppy</span></code></pre></div>
 <p>NOTE: If the version of your lilo is not 21.4, use the appropriate boot.b file.</p>
 <p>NOTE: If your floppy drive is not <code>/dev/fd0</code>, edit lilo.conf appropriately.</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="ex">lilo</span> <span class="at">-C</span> /mnt/floppy/lilo.conf</span></code></pre></div>
+<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="ex">lilo</span> <span class="at">-C</span> /mnt/floppy/lilo.conf</span></code></pre></div>
 <p>Boot from the floppy on an x86 machine with a PS/2 keyboard and mouse.
 Move the window away from the corner.</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">vi</span> gavin.c</span></code></pre></div>
+<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">vi</span> gavin.c</span></code></pre></div>
 <p>Scroll up and down the file with up-arrow and down-arrow.</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">sh</span></span></code></pre></div>
+<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">sh</span></span></code></pre></div>
 <p>You can have several shell windows:</p>
-<div class="sourceCode" id="cb9"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="fu">vi</span> README.md</span>
-<span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a><span class="ex">./prim</span></span></code></pre></div>
+<div class="sourceCode" id="cb9"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a>    <span class="fu">vi</span> README.md</span>
+<span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a>    <span class="ex">./prim</span></span></code></pre></div>
 <p>Press and hold any key.</p>
 <h2 id="alternate-code">Alternate code:</h2>
 <p>This version’s main difference is that the macro <code>K</code> is redefined to <code>1</code> so that
 you can use it with <code>QEMU</code>.</p>
 <h3 id="alternate-build">Alternate build:</h3>
-<div class="sourceCode" id="cb10"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> alt</span></code></pre></div>
+<div class="sourceCode" id="cb10"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb10-1"><a href="#cb10-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>The use is mostly the same as <code>gavin</code> except that one initially executes <code>gavin.alt</code>
 (which <code>make alt</code> will do) and one will have to use <code>QEMU</code> instead. The files
@@ -257,7 +256,7 @@ data &amp; code suitable for the new target platform.
 Accesses to data in the string are made relative to the define <code>V</code>,
 so these may need updating as appropriate (<code>0x90200</code> is the address
 at which a Linux bootloader loads an x86 kernel image).</p>
-<pre><code>\* ;-)</code></pre>
+<pre><code>    \* ;-)</code></pre>
 <!--

    Copyright © 1984-2024 by Landon Curt Noll. All Rights Reserved.