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

add FAQ 1.5 (BOZ) and FAQ 3.23 (zlib)

Browse Source 
In addition to adding the above mentioned FAQ entries,
we made sure that FAQ sections were preceded by 2 empty lines.
This commit is contained in:
Landon Curt Noll committed 2024-10-13 20:20:28 -07:00
1 parent ad02538581
commit 4386b63a8d
2 files changed
+134 -1
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

faq.html
+45
View File
@@ -417,6 +417,7 @@
<li><a class="normal" href="#faq1_2">1.2 - What is the history of the IOCCC website?</a></li>
<li><a class="normal" href="#faq1_3">1.3 - How has the IOCCC size limit rule changed over the years?</a></li>
<li><a class="normal" href="#faq1_4">1.4 - What is the <strong>Great Fork Merge</strong>?</a></li>
<li><a class="normal" href="#faq1_5">1.5 - What is an IOCCC BOF?</a></li>
</ul>
<h2 id="section-2---ioccc-judging-process">Section 2 - <a href="#faq2">IOCCC Judging process</a></h2>
<ul>
@@ -453,6 +454,7 @@
<li><a class="normal" href="#faq3_20">3.20 - How do I download individual winning entries or all winning entries of a given year?</a></li>
<li><a class="normal" href="#faq3_21">3.21 - What are <code>try.sh</code> and <code>try.alt.sh</code> scripts and why should I use them?</a></li>
<li><a class="normal" href="#faq3_22">3.22 - Are there any compiler warnings that I should not worry about?</a></li>
<li><a class="normal" href="#faq3_23">3.23 - How do I compile an IOCCC entry that requires zlib?</a></li>
</ul>
<h2 id="section-4---changes-made-to-ioccc-entries">Section 4 - <a href="#faq4">Changes made to IOCCC entries</a></h2>
<ul>
@@ -2205,6 +2207,17 @@ to the <a href="https://github.com/ioccc-src/winner">Official IOCCC winner repo<
FAQ on “<a href="#great_fork_merge_date">Great Fork Merge Date</a>”
for more information.</p>
<p>Jump to: <a href="#">top</a></p>
<div id="faq1_5">
<div id="ioccc_bof">
<h3 id="faq-1.5-what-is-an-ioccc-bof">FAQ 1.5: What is an IOCCC BOF?</a></h3>
</div>
</div>
<p>The term <strong>IOCCC BOF</strong> stood for <strong>International Obfuscated C Code
Contest Birds Of a Feather</strong>. It was a special session held at the
general <a href="https://www.usenix.org/conferences">USENIX conference</a>, usually
immediately after the BSD BOF, where the winners of a new IOCCC were
announced in the early years of the IOCCC.</p>
<p>Jump to: <a href="#">top</a></p>
<div id="faq2">
<h2 id="section-2-ioccc-judging-process">Section 2: IOCCC Judging process</h2>
</div>
@@ -3288,6 +3301,38 @@ inevitable in obfuscated code and even non-obfuscated code.</p>
<p>If you <em>can</em> work past this it might be good but this is not something that
should be worried about too much as this is on the compiler developers, not you.</p>
<p>Jump to: <a href="#">top</a></p>
<div id="faq3_23">
<div id="zlib">
<h3 id="faq-3.23-how-do-i-compile-an-ioccc-entry-that-requires-zlib">FAQ 3.23: How do I compile an IOCCC entry that requires zlib?</h3>
</div>
</div>
<p>This depends on your operating system but below are instructions for Linux and
macOS with alternative methods for macOS and different package managers with Linux.</p>
<h4 id="red-hat-based-linux-8">Red Hat based Linux</h4>
<p>Execute the following as root or via sudo:</p>
<pre><code> dnf install zlib</code></pre>
<h4 id="macos-8">macOS</h4>
<p>With macOS it should already be installed. If it is not you might have to do:</p>
<pre><code> xcode-select --install</code></pre>
<p>and agree to the terms and conditions and proceed with the install.</p>
<h5 id="macos-via-homebrew-6">macOS via Homebrew</h5>
<p>Not applicable, see above.</p>
<h5 id="macos-via-macports-6">macOS via MacPorts</h5>
<p>Not applicable, see above.</p>
<h4 id="debian-based-linux-8">Debian based Linux</h4>
<p>Execute the following as root or via sudo:</p>
<pre><code> apt install zlib1g zlib1g-dev</code></pre>
<p>and then try <code>make all</code> again.</p>
<h4 id="other-linux-distributions-8">Other Linux distributions</h4>
<p>Use your package manager to install the appropriate packages. Try the search
feature of the package manager to determine which packages you need to install.
Note that you might have to install both the library and the developmental
packages: one for compiling and one for linking / running.</p>
<h4 id="package-website-8">Package website</h4>
<p>Go to the <a href="https://invisible-island.net/ncurses/">ncurses website</a> and follow their instructions
for downloading, installing and using ncurses.</p>
<p>We recommend trying a method suitable for your environment first, if possible.</p>
<p>Jump to: <a href="#">top</a></p>
<div id="faq4">
<h2 id="section-4-changes-made-to-ioccc-entries">Section 4: Changes made to IOCCC entries</h2>
</div>
faq.md
+89 -1
View File
@@ -29,6 +29,7 @@ This is FAQ version **28.0.4 2024-08-24**.
- <a class="normal" href="#faq1_2">1.2 - What is the history of the IOCCC website?</a>
- <a class="normal" href="#faq1_3">1.3 - How has the IOCCC size limit rule changed over the years?</a>
- <a class="normal" href="#faq1_4">1.4 - What is the **Great Fork Merge**?</a>
- <a class="normal" href="#faq1_5">1.5 - What is an IOCCC BOF?</a>
## Section 2 - [IOCCC Judging process](#faq2)
@@ -65,6 +66,7 @@ This is FAQ version **28.0.4 2024-08-24**.
- <a class="normal" href="#faq3_20">3.20 - How do I download individual winning entries or all winning entries of a given year?</a>
- <a class="normal" href="#faq3_21">3.21 - What are `try.sh` and `try.alt.sh` scripts and why should I use them?</a>
- <a class="normal" href="#faq3_22">3.22 - Are there any compiler warnings that I should not worry about?</a>
- <a class="normal" href="#faq3_23">3.23 - How do I compile an IOCCC entry that requires zlib?</a>
## Section 4 - [Changes made to IOCCC entries](#faq4)
@@ -119,6 +121,7 @@ Jump to: [top](#)
# The IOCCC FAQ
<div id="faq0">
## Section 0: Submitting entries to a new IOCCC
</div>
@@ -2143,6 +2146,21 @@ for more information.
Jump to: [top](#)
<div id="faq1_5">
<div id="ioccc_bof">
### FAQ 1.5: What is an IOCCC BOF?</a>
</div>
</div>
The term **IOCCC BOF** stood for **International Obfuscated C Code
Contest Birds Of a Feather**. It was a special session held at the
general [USENIX conference](https://www.usenix.org/conferences), usually
immediately after the BSD BOF, where the winners of a new IOCCC were
announced in the early years of the IOCCC.
Jump to: [top](#)
<div id="faq2">
## Section 2: IOCCC Judging process
</div>
@@ -3377,7 +3395,6 @@ for downloading, installing and using netpbm.
We recommend trying a method suitable for your environment first, if possible.
<div id="faq3_16">
<div id="libjpeg">
### 3.16 - How do I compile and install libjpeg-turbo for entries that require it?
@@ -3764,6 +3781,7 @@ browser to `1984/index.html`, scroll down to `Winning Entries of 1984 - The 1st
IOCCC` and click on the link `1984/mullender` which will take you to the
`index.html` file. Of course the caveats listed above still will apply.
<div id="faq3_21">
<div id="try">
### 3.21 - What are `try.sh` and `try.alt.sh` scripts and why should I use them?
@@ -3791,6 +3809,7 @@ process or appreciate the entry more, then please do so.
Jump to: [top](#)
<div id="faq3_22">
<div id="forced_warnings">
### 3.22 - Are there any compiler warnings that I should not worry about?
@@ -3815,6 +3834,75 @@ should be worried about too much as this is on the compiler developers, not you.
Jump to: [top](#)
<div id="faq3_23">
<div id="zlib">
### FAQ 3.23: How do I compile an IOCCC entry that requires zlib?
</div>
</div>
This depends on your operating system but below are instructions for Linux and
macOS with alternative methods for macOS and different package managers with Linux.
#### Red Hat based Linux
Execute the following as root or via sudo:
``` <!---sh-->
dnf install zlib
```
#### macOS
With macOS it should already be installed. If it is not you might have to do:
``` <!---sh-->
xcode-select --install
```
and agree to the terms and conditions and proceed with the install.
##### macOS via Homebrew
Not applicable, see above.
##### macOS via MacPorts
Not applicable, see above.
#### Debian based Linux
Execute the following as root or via sudo:
``` <!---sh-->
apt install zlib1g zlib1g-dev
```
and then try `make all` again.
#### Other Linux distributions
Use your package manager to install the appropriate packages. Try the search
feature of the package manager to determine which packages you need to install.
Note that you might have to install both the library and the developmental
packages: one for compiling and one for linking / running.
#### Package website
Go to the [ncurses website](https://invisible-island.net/ncurses/) and follow their instructions
for downloading, installing and using ncurses.
We recommend trying a method suitable for your environment first, if possible.
Jump to: [top](#)
<div id="faq4">
## Section 4: Changes made to IOCCC entries
</div>