From 1023fe227fc31bd3d51cb3aff0295d2e236b408c Mon Sep 17 00:00:00 2001
From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com>
Date: Sat, 13 Apr 2024 06:49:34 -0700
Subject: [PATCH] Add FAQ 3.19: make(1) compatibility

This FAQ entry explains that the IOCCC only supports GNU make(1)
Makefiles.
---
 faq.html | 19 +++++++++++++++++++
 faq.md   | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)

diff --git a/faq.html b/faq.html
index 03887867e..6d1d6ed89 100644
--- a/faq.html
+++ b/faq.html
@@ -170,6 +170,7 @@
 <li><a href="#faq3_16">3.16 - How do I compile and install libjpeg-turbo for entries that require it?</a></li>
 <li><a href="#faq3_17">3.17 - How do I compile and install ImageMagick for entries that require it?</a></li>
 <li><a href="#faq3_18">3.18 - How do I compile and install OpenGL for entries that require it?</a></li>
+<li><a href="#faq3_19">3.19 - What kind of make(1) compatibility does the IOCCC support and will it support other kinds?</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>
@@ -1413,6 +1414,24 @@ packages: one for compiling and one for linking / running.</p>
 <p>Go to the <a href="https://vulkan.org">Vulkan website</a> and follow their instructions
 for downloading, installing and using OpenGL.</p>
 <p>We recommend trying a method suitable for your environment first, if possible.</p>
+<h3 id="what-kind-of-make1-compatibility-does-the-ioccc-support-and-will-it-support-other-kinds"><a name="faq3_19"></a><a name="make_compatibility"></a>3.19 - What kind of make(1) compatibility does the IOCCC support and will it support other kinds?</h3>
+<p>For the <a href="https://www.ioccc.org">IOCCC</a> <a href="https://github.com/ioccc-src/mkiocccentry">mkiocccentry submission
+toolkit</a> and the <a href="years.html">winning IOCCC
+entries</a> we support <em>ONLY</em> GNU Makefile syntax. This means that if
+you only have Cygwin or a BSD <code>make(1)</code> (often <code>bmake(1)</code>) or some other
+<code>make(1)</code> utility the Makefiles we use will not be compatible.</p>
+<p>We do not intend on supporting anything but the GNU <code>make(1)</code> utility so if you
+do not currently have it installed you will have to do that in order to compile
+entries for the IOCCC. If you are submitting an entry this will also be
+necessary.</p>
+<p>If you do not have GNU <code>make(1)</code> you might look for <code>gmake</code> as that is what it
+often is packaged as. Then you can use <code>gmake</code> instead. For instance if you go
+to the top level directory of the winner repo you can do:</p>
+<pre class="&lt;!---sh--&gt;"><code>    gmake</code></pre>
+<p>In the case that the Makefile uses the <code>MAKE</code> variable you will have to override
+it like:</p>
+<pre class="&lt;!---sh--&gt;"><code>    gmake MAKE=gmake</code></pre>
+<p>though of course for both you may specify a rule or rules to run.</p>
 <h2 id="section-4-changes-made-to-ioccc-entries"><a name="faq4"></a>Section 4: Changes made to IOCCC entries</h2>
 <h3 id="faq-4.0-why-are-some-winning-entry-remarks-incongruent-with-the-winning-ioccc-code"><a name="faq4_0"></a>FAQ 4.0: Why are some winning entry remarks incongruent with the winning IOCCC code?</h3>
 <p>It is very likely in this case that the code was fixed to work for modern
diff --git a/faq.md b/faq.md
index 4e6c907e7..13e889706 100644
--- a/faq.md
+++ b/faq.md
@@ -43,6 +43,7 @@
 - [3.16 - How do I compile and install libjpeg-turbo for entries that require it?](#faq3_16)
 - [3.17 - How do I compile and install ImageMagick for entries that require it?](#faq3_17)
 - [3.18 - How do I compile and install OpenGL for entries that require it?](#faq3_18)
+- [3.19 - What kind of make(1) compatibility does the IOCCC support and will it support other kinds?](#faq3_19)
 
 
 ## Section  4 - [Changes made to IOCCC entries](#faq4)
@@ -1955,6 +1956,37 @@ for downloading, installing and using OpenGL.
 We recommend trying a method suitable for your environment first, if possible.
 
 
+### <a name="faq3_19"></a><a name="make_compatibility"></a>3.19 - What kind of make(1) compatibility does the IOCCC support and will it support other kinds?
+
+For the [IOCCC](https://www.ioccc.org) [mkiocccentry submission
+toolkit](https://github.com/ioccc-src/mkiocccentry) and the [winning IOCCC
+entries](years.html) we support *ONLY* GNU Makefile syntax. This means that if
+you only have Cygwin or a BSD `make(1)` (often `bmake(1)`) or some other
+`make(1)` utility the Makefiles we use will not be compatible.
+
+We do not intend on supporting anything but the GNU `make(1)` utility so if you
+do not currently have it installed you will have to do that in order to compile
+entries for the IOCCC. If you are submitting an entry this will also be
+necessary.
+
+If you do not have GNU `make(1)` you might look for `gmake` as that is what it
+often is packaged as. Then you can use `gmake` instead. For instance if you go
+to the top level directory of the winner repo you can do:
+
+``` <!---sh-->
+    gmake
+```
+
+In the case that the Makefile uses the `MAKE` variable you will have to override
+it like:
+
+``` <!---sh-->
+    gmake MAKE=gmake
+```
+
+though of course for both you may specify a rule or rules to run.
+
+
 ## <a name="faq4"></a>Section 4: Changes made to IOCCC entries