mkiocccentry tool and how do I use it?
-mkiocccentry and its related tools?
-mkiocccentry tool and how do I use it?mkiocccentry and its related tools?mkiocccentry tool?fnamchk tool?
-.auth.json and/or .info.json files?
-.auth.json file?
-.info.json file?
-author handle?
-author_handle.json file and how are they used?
-entry_id?
-.entry.json file and how is it used?
-fnamchk tool?.auth.json and/or .info.json files?.auth.json file?.info.json file?author handle?author_handle.json file and how are they used?entry_id?.entry.json file and how is it used?try.sh and try.alt.sh scripts and why should I use them?
-try.sh and try.alt.sh scripts and why should I use them?.top, .allyear, .year and .path files?
-.top, .allyear, .year and .path files?Jump to: top
Jump to: top
-Jump to: top
- -mkiocccentry tool and how do I use it?mkiocccentry and its related tools?mkiocccentry repo.
See also the mkiocccentry repo FAQ for more up to date information on downloading, compiling, and related FAQ information.
-Jump to: top - -Jump to: top
Jump to: top
- -Makefile should copy prog.c into the desired file
make compatible make(1)
command that is compatible with GNU Make version 3.81.
Jump to: top
- -Jump to: top
- -.auth.json file?.auth.json file.
If you wish to verify that your .auth.json file is valid JSON then see the
FAQ on “validating JSON documents”.
Jump to: top
-.info.json file?.info.json file.
If you wish to verify that your .info.json file is valid JSON then see the
FAQ on “validating JSON documents”.
Jump to: top
--v option. For instance:
If the tool is not installed then you will obviously have to specify the path of the tool.
Jump to: top
- -.auth.json and/or .info.json files?Jump to: top
-prog.c or some other important file!
To make use of the answers file, use the -i answers option like:
mkiocccentry -i answers.txt ...Jump to: top
-Jump to: top
-See the markdown syntax guide. See also CommonMark Spec.
Jump to: top
- -mkiocccentry tool?Jump to: top
-Jump to: top
-See also the FAQ on “rules, guidelines, tools feedback”.
Jump to: top
- -
Q: How can I comment or make a suggestion on IOCCC rules, guidelines and tools?
@@ -1947,8 +1698,6 @@ have to say, consider adding comments to that particular discussion. Otherwise consider opening a new mkiocccentry discussion.Jump to: top
- -Q: How many submissions do the judges receive for a given IOCCC?
@@ -1956,8 +1705,6 @@ discussion.By tradition, we do not say.
Jump to: top
- -Q: What types of entries have been frequently submitted to the IOCCC?
Jump to: top
-Q: Why don’t you publish submissions that do not win?
@@ -2073,8 +1818,6 @@ of the same theme. Anyone is free to put their IOCCC hopefuls, lookalikes and/or entries that do not win on their web page for everyone to see.Jump to: top
- -Q: How much time does it take to judge the contest?
Jump to: top
-Q: How many judging rounds do you have?
@@ -2108,8 +1849,6 @@ also report when we enter what we believe is the final judging round, so you may guess that we have at least 3 rounds. :-) The actual number of rounds is certainly more than 3.Jump to: top
- -These could be considered the ‘best entry’ for those years with 1 or more other entries that came in close behind.
Jump to: top
- -Update the IOCCC news page, also by updating this repo.
Jump to: top
---
Jump to: top
-
--
@@ -2270,8 +2003,6 @@ or more of these tools manually.
--
@@ -2298,8 +2029,6 @@ of this document to discuss the many tests that -
Section 3: The mkiocccentry toolkit: finer details
Q: What sort of checks does the mkiocccentry tool perform?
See also the Guidelines and the Rules (and in particular Rule 17).
Jump to: top -txzchk(1)runs; if know we refer you to the source code.Jump to: top
- -Q: FAQ 0.14 - What is the
@@ -2320,16 +2049,12 @@ you can do so. For instance: FAQ on “validating your submission tarball” for more information.fnamchktool?Jump to: top
---
--
-
-
-
@@ -2461,8 +2180,6 @@ Please see the
FAQ on “fixing an entry”
for details.
-
-
@@ -2501,8 +2216,6 @@ longer be available, code wise, except for Plan 9, but Plan 9 was never used for
judging the IOCCC. A Unix man page for
--
@@ -2518,8 +2231,6 @@ usually away with -
-
@@ -2734,8 +2443,6 @@ fix it and make a pull request.
FAQ on “GitHub pull request”
for more information about pull requests.
--
@@ -2766,8 +2473,6 @@ packages: one for compiling and one for linking / running.
for downloading, installing and using ncurses.
--
-
@@ -2867,8 +2570,6 @@ differences, try from
--
@@ -2897,8 +2598,6 @@ to find what the -
-
@@ -3246,8 +2943,6 @@ inevitable in obfuscated code and even non-obfuscated code.
--
@@ -3278,16 +2973,12 @@ packages: one for compiling and one for linking / running.
for downloading, installing and using zlib.
--
--
@@ -3301,40 +2992,30 @@ then run:
Section 4: Compiling IOCCC entries
Jump to: top
-Q: What Makefile rules are available to build or clean up IOCCC entries?
@@ -2371,8 +2096,6 @@ compilers might do different things, have different defects or other issues. Note that theMakefiles check theCCvariable by substrings so that if you were to do something likemake CC=gcc=mp-12it would register asgcc.Jump to: top
- -Q: Why don’t certain IOCCC entries compile?
@@ -2406,8 +2129,6 @@ for more information. fixed so that they can compile in modern systems though just because an entry compiles does not mean it will run on your specific system.Jump to: top
- -Q: Why does an IOCCC entry fail to run on my 64-bit system?
@@ -2439,8 +2160,6 @@ for details. See also the FAQ on “GitHub pull request” for more information about pull requests.Jump to: top
- -Jump to: top
- -Q: Why does clang or gcc fail to compile some IOCCC entries?
@@ -2491,8 +2208,6 @@ See also the FAQ on “GitHub pull request” for more information about pull requests.Jump to: top
- -Q: What is this cb tool that is mentioned in the IOCCC?
cbstill exists.Jump to: top
-stty echo. Sometimes you can also get away with < clearing of the screen, however, that solves the problem, soclearwill not help.Jump to: top
- -Q: How do I compile and run an IOCCC entry that requires X11?
@@ -2671,8 +2382,6 @@ See the FAQ on “X.org deprecated” for more information.Jump to: top
- -Q: How do I compile and install SDL1 or SDL2 for entries that require it?
Jump to: top
-Q: How do I compile and install (n)curses for entries that require it?
We recommend trying a method suitable for your environment first, if possible.
Jump to: top
-Q: How do I compile and run an IOCCC entry that requires sound?
@@ -2801,8 +2506,6 @@ include this here, at least for now.Usually the index.html file will explain how to use it under Linux so we do not include this here, at least for now.
Jump to: top
- -Q: Why do Makefiles use -Weverything with clang?
1989/westley: you can get your entry to work well inclangit might very well be considered better than other entries.Jump to: top
-intris set to: reason it’s not you might have to do something else including just piping it to justgrep intror whatever.Jump to: top
- -Q: Why does an IOCCC entry fail to compile and/or fail to run?
@@ -2937,8 +2636,6 @@ Please see the FAQ on “fixing an entry” for how to submit a fix to an IOCCC entry.Jump to: top
- -Q: FAQ 3.14 - How do I compile and install tcpserver for entries that require it?
If you can 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.
Jump to: top
-Q: How do I compile and install zlib for IOCCC entries that require it?
We recommend trying a method suitable for your environment first, if possible.
Jump to: top
-Q: How do I install Ruby for entries that require it?
Please see the official Ruby installation guide.
Jump to: top
-Q: How do I install rake for entries that require it?
Once this is done, try as root or via
Jump to: top -sudo:--
Jump to: top
-
Section 5: Dependencies for some IOCCC entries
--
Section 6: Problems compiling IOCCC entries
Jump to: top
---
Section 7: Running IOCCC entries
Jump to: top
---
--
-
-
@@ -3498,8 +3175,6 @@ are the original winning entry or as close to as possible to the original that
we can find (in some cases a change was made by the Judges, for example, or an
author might have made a modification without saving the original).
--
-
-
@@ -3573,8 +3244,6 @@ method of how to display files was devised).
other times something else.
--
@@ -3641,16 +3310,12 @@ the source code as it is now now, try:
FAQ on “what changed”
for more information and make rules relating to “original source file” differences.
Section 8: Changes made to IOCCC entries
Jump to: top
-Q: Why were some calls to the libc function gets(3) changed to use fgets(3)?
@@ -3371,8 +3052,6 @@ in the name of backward compatibility. problem and it is this that has complicated most of the fixes though again some can look almost identical.Jump to: top
- -Q: How can I find out what was changed in an IOCCC entry source code?
@@ -3488,8 +3167,6 @@ and the FAQ on “entry source code changes” for more information.Jump to: top
- -Q: What is the meaning of the file ending in .orig.c in IOCCC entries?
Jump to: top
-Q: What are alternate versions and why were alternate versions added to some entries when the original entry worked fine and well?
@@ -3529,8 +3204,6 @@ judgement call. FAQ on “original source code” for more information.Jump to: top
- -Q: Why was arg count and/or type changed in main() in some older entries?
@@ -3549,8 +3222,6 @@ could no longer be so:main()instead had to call another function the body of the oldmain()and that function would call itself again. In some cases, however, this had to be done even withoutclangobjections.Jump to: top
- -Q: Why were some filenames changed?
There were certainly other reasons as well.
Jump to: top
-Jump to: top
---
--
-
-
-
-
@@ -3945,8 +3602,6 @@ replace that text with:
--
-
@@ -4046,16 +3699,12 @@ happy to include any whatever notes and/or comments from your new discussion
that be prove helpful.
Section 9: Helping the IOCCC
Jump to: top
-Q: How can I help the IOCCC?
@@ -3671,8 +3336,6 @@ In cases where the bug is known, the entry’s known bugsWe welcome your help on fixing the IOCCC website
Jump to: top
- -Q: How do I report a bug in an IOCCC entry?
@@ -3696,8 +3359,6 @@ IOCCC entry. See also the FAQ on “GitHub pull request” for more information about pull requests.Jump to: top
- -Q: How can I submit a fix to an IOCCC entry?
@@ -3737,8 +3398,6 @@ for more information about pull requests.Note that we’re much more inclined to accept an author’s fixes but the judges have the final say in the matter.
Jump to: top
- -Q: How can I report an IOCCC website problem?
@@ -3764,8 +3423,6 @@ already been reported. If it has been reported, feel free to add a comment to the issue. Otherwise, if you do not see the same issue reported, then feel free to open a new IOCCC website issue.Jump to: top
- -Q: How can I submit a fix to the IOCCC website?
If you just wish to report the bad link issue, see FAQ on “report website problem”.
Jump to: top
-Q: How can I support the IOCCC?
@@ -3965,8 +3620,6 @@ better for everyone. :-) efforts, we suggest making an Anonymous gift via the IOCCC Amazon wishlist.Jump to: top
- -THANK YOU in advance for your willingness to assist!
Jump to: top
---
--
-
@@ -4087,8 +3734,6 @@ variety of kinds.
not an issue and note that some issues are simply missing files, dead URL(s) or
something like that.
-
@@ -4118,8 +3763,6 @@ and certainly OUT OF DATE.
-
-
@@ -4179,8 +3820,6 @@ exaggeration.
alt="image of F.D.C.Willard.png"
width=600 height=401>
-
-
-
-
@@ -4577,8 +4210,6 @@ For example see top
-
--
@@ -4630,8 +4261,6 @@ such as old rules and old guidelines, terms such as entry may still be
found. Moreover, out of habit, the IOCCC judges sometimes use old
names such as entry when they should use submission. Sorry (tm Canada)! :-)
--
-
-
@@ -4855,8 +4480,6 @@ follow posts something so you will have to check the IOCCC feed manually.
mastodon feed page and/or mastodon
app from time to time to view IOCCC mastodon updates.
--
@@ -4890,8 +4513,6 @@ how they are used.
FAQ on “Author, Entry, Submission”
for more information on terms such as author, entry, and submission.
--
@@ -4902,8 +4523,6 @@ can hit ESC to do this) and then type the command:
--
@@ -4987,8 +4606,6 @@ least r
issue (choose
the category Website issue).
--
@@ -5007,8 +4624,6 @@ JSON files.
authors.html and click on their surname’s/last name’s/second
name’s initial and then scroll down (if necessary) to the author in question.
--
@@ -5425,8 +5040,6 @@ source code (if there is an alternate version). Some, however, have another file
name. The
--
@@ -5470,18 +5083,14 @@ and inexplicable.
already happened.” 😜
Section 10: Miscellaneous IOCCC
Jump to: top
-Q: How did an entry that breaks the size rule 2 win the IOCCC?
@@ -4072,8 +3721,6 @@ original winning entries as compressed tar files for a given year. “abuse of the rules” (although now blatant abuse of the rules to get around rule 2 size limits is discouraged).Jump to: top
- -Jump to: top
- -If you do make a new fork of THIS repo, we do ask that your fork keep up to date with the latest changes when possible. Thank you.
Jump to: top
- -Q: May I use parts of the IOCCC in an article, book, newsletter, or instructional material?
@@ -4138,8 +3781,6 @@ See the Copyright at the bottom of IOCCC web pages for FAQ on “using IOCCC content”. For additional information on the Copyright and CC BY-SA 4.0 License.Jump to: top
- -Jump to: top
- -Q: What is an
@@ -4230,8 +3869,6 @@ in the case of top - -author_handle?Q: What is an
@@ -4539,8 +4176,6 @@ FAQ on “fixing author information” for information about how to update and/or correct IOCCC author information.author_handle.jsonfile and how are they used?Jump to: top
- -Q: What is an
@@ -4553,8 +4188,6 @@ of 2020 is found under the following directory:entry_id?The
entry_idfor that winning entry is:Jump to: top
- -Q: What is the current meaning of the IOCCC terms Author, Entry, and Submission?
Jump to: top
-Q: How do I make a pull request to the GitHub repo?
@@ -4795,8 +4424,6 @@ example, you would type:This will merge your pull request to your fork.
Jump to: top
- -Q: Am I allowed to use IOCCC content?
@@ -4825,8 +4452,6 @@ enjoy hat those working on the IOCCC have proper Attribution including, of course, the IOCCC winners themselves! It is designed to help ensure that everyone may enjoy the IOCCC.Jump to: top
- -Q: What is Mastodon and why does IOCCC use it?
Jump to: top
-Q: How can I find my author handle?
Jump to: top
-Q: How do I set certain tabstops for viewing source code in vi(m)?
where
4is the value you wish to set the tabstop to.Jump to: top
-Q: FAQ 6.15 - How do the menus on the website work and what can I do if they don’t work?
Jump to: top
-Q: FAQ 6.16 - How do I find more information about a winning author of an entry?
Jump to: top
-Q: What is a
.entry.jsonfile and how is it used?entry_textfor thetryscripts will bescript to try entryor something along those lines.Jump to: top
-Q: I do not understand the IOCCC, can you explain it to me?
Share and enjoy! ☺️
---
--
@@ -5545,8 +5154,6 @@ and the tradition continues as the longest running contest on the Internet.
-
@@ -5556,8 +5163,6 @@ do not permit us to hold a new IOCCC.
--
-
- Rule 2b: 2503
-
@@ -5797,8 +5398,6 @@ to the Official IOCCC winner repo<
FAQ on “Great Fork Merge Date”
for more information.
--
Section 11: History of the IOCCC
Jump to: top
-P.S. Part of the inspiration for making the IOCCC a contest goes to the Bulwer-Lytton fiction contest.
Jump to: top
- -Q: Why are some years missing IOCCC entries?
The pause during the 2021-2023 period was due to the IOCCC judges developing tools to make it much more likely for the IOCCC to be held on a yearly basis later on.
Jump to: top
-Q: What is the history of the IOCCC website?
@@ -5718,8 +5323,6 @@ of the IOCCC winner repo. repo resulting in many, many substantial improvements to the official IOCCC website.Jump to: top
- -Q: How has the IOCCC size limit rule changed over the years?
@@ -5784,8 +5387,6 @@ to the official IOCCC website.Jump to: top
- -Q: What is the Great Fork Merge?
Jump to: top
-Q: What is an IOCCC BOF?
@@ -5810,7 +5409,6 @@ general USENIX conference, usua immediately after the BSD BOF, where the winners of a new IOCCC were announced in the early years of the IOCCC. Jump to: top -diff --git a/faq.md b/faq.md index 2f9901ef4..984506be4 100644 --- a/faq.md +++ b/faq.md @@ -9,172 +9,124 @@ This is FAQ version **28.0.9 2024-10-19**. -->
--
## 0. [Entering the IOCCC: the bare minimum you need to know](#enter_questions)
-
+- How can I enter the IOCCC?
+- What is the `mkiocccentry` tool and how do I use it?
+- How do I compile `mkiocccentry` and its related tools?
+- What platform should I assume for my submission?
+- What should I put in my submission Makefile?
+- What should I put in the remarks.md file of my submission?
--
## 1. [Entering the IOCCC: more help and details](#submitting_help)
-
+- Is there a way to not have to re-enter the same information, when making a change to my submission?
+- May I use a different source or compiled filename than prog.c or prog?
+- What are the IOCCC best practices for using markdown?
+- How do I report bugs in an `mkiocccentry` tool?
--
## 2. [IOCCC Judging process](#judging)
-
+- What is the best way to ask a question about the IOCCC rules, guideline and tools?
+- How can I comment or make a suggestion on IOCCC rules, guidelines and tools?
+- Are there any compiler warnings that I should not worry about?
+- What types of entries have been frequently submitted to the IOCCC?
+- How did an entry that breaks the size rule 2 win the IOCCC?
+- How many submissions do the judges receive for a given IOCCC?
+- How much time does it take to judge the contest?
+- How many judging rounds do you have?
+- Why do some IOCCC entries receive the Grand Prize or Best of Show award?
+- How are winning IOCCC entries announced?
+- Why don't you publish submissions that do not win?
--
## 3. [The mkiocccentry toolkit: finer details](#mkiocccentry_details)
-
+- What sort of checks does the mkiocccentry tool perform?
+- How can I validate my submission tarball?
+- What is the `fnamchk` tool?
+- How can I validate my `.auth.json` and/or `.info.json` files?
+- What is a `.auth.json` file?
+- What is a `.info.json` file?
+- What is an `author handle`?
+- What is an `author_handle.json` file and how are they used?
+- How can I find my author handle?
+- What is an `entry_id`?
+- What is a `.entry.json` file and how is it used?
+- How can I validate any JSON document?
--
## 4. [Compiling IOCCC entries](#compiling)
-
+- What Makefile rules are available to build or clean up IOCCC entries?
+- What kind of make(1) compatibility does the IOCCC support and will it support other kinds?
--
## 5. [Dependencies for some IOCCC entries](#dependencies)
-
+- How do I compile and run an IOCCC entry that requires X11?
+- How do I compile and install SDL1 or SDL2 for entries that require it?
+- How do I compile and install (n)curses for entries that require it?
+- How do I compile and run an IOCCC entry that requires sound?
+- How do I compile and install tcpserver for entries that require it?
+- How do I compile and install netpbm for entries that require it?
+- How do I compile and install libjpeg-turbo for entries that require it?
+- How do I compile and install ImageMagick for entries that require it?
+- How do I compile and install OpenGL for entries that require it?
+- How do I download individual winning entries or all winning entries of a given year?
+- How do I compile and install zlib for IOCCC entries that require it?
+- How do I install Ruby for entries that require it?
+- How do I install rake for entries that require it?
--
## 6. [Problems compiling IOCCC entries](#compile_problems)
-
+- Why don't certain IOCCC entries compile?
+- Why does clang or gcc fail to compile some IOCCC entries?
+- Why do some IOCCC entries fail to compile under macOS?
+- Why do Makefiles use -Weverything with clang?
--
## 7. [Running IOCCC entries](#running_entries)
-
+- What are `try.sh` and `try.alt.sh` scripts and why should I use them?
+- An IOCCC entry messed up my terminal application, how do I fix this?
+- Why does an IOCCC entry fail to run on my 64-bit system?
+- How do I find out how to send interrupt/EOF etc. for entries that require it?
+- Why does an IOCCC entry fail to compile and/or fail to run?
--
## 8. [Changes made to IOCCC entries](#changes)
-
-- What is the meaning of the file ending in .orig.c in IOCCC entries?
-- What are alternate versions and why were alternate versions added to some entries when the original entry worked fine and well?
-- Why was arg count and/or type changed in main() in some older entries?
-- Why were files added to, removed from or changed in some entries?
-- What is the original source file?
-
-
+- How can I find out what was changed in an IOCCC entry source code?
+- Why were some calls to the libc function gets(3) changed to use fgets(3)?
+- Why do author remarks sometimes not match the source and/or why are there
+other inconsistencies with the original entry?
+- What is the meaning of the file ending in .orig.c in IOCCC entries?
+- What are alternate versions and why were alternate versions added to some entries when the original entry worked fine and well?
+- Why was arg count and/or type changed in main() in some older entries?
+- Why were files added to, removed from or changed in some entries?
+- What is the original source file?
--
## 9. [Helping the IOCCC](#help)
-
+- How can I help the IOCCC?
+- Is there a list of known bugs and (mis)features of IOCCC entries?
+- How can I submit a fix to an IOCCC entry?
+- How do I make a pull request to the GitHub repo?
+- How can I report an IOCCC website problem?
+- How can I submit a fix to the IOCCC website?
+- How can I correct or update an IOCCC author's information?
+- What should I do if I find a broken or wrong web link?
+- How can I support the IOCCC?
+- I deobfuscated some entry code, may I contribute the source?
+- How do I report a bug in an IOCCC entry?
--
## 10. [Miscellaneous IOCCC](#misc)
-
+- May I mirror the IOCCC website?
+- May I use parts of the IOCCC in an article, book, newsletter, or instructional material?
+- Why do you sometimes use the first person plural?
+- What is the purpose of the `.top`, `.allyear`, `.year` and `.path` files?
+- What is the current meaning of the IOCCC terms Author, Entry, and Submission?
+- Am I allowed to use IOCCC content?
+- What is Mastodon and why does IOCCC use it?
+- How do I set certain tabstops for viewing source code in vi(m)?
+- How do the menus on the website work and what can I do if they don't work?
+- How do I find more information about a winning author of an entry?
+- What is this cb tool that is mentioned in the IOCCC?
--
## 11. [History of the IOCCC](#ioccc_history)
-
+- How did the IOCCC get started?
+- Why are some years missing IOCCC entries?
+- What is the history of the IOCCC website?
+- How has the IOCCC size limit rule changed over the years?
+- What is the **Great Fork Merge**?
+- What is an IOCCC BOF?
+- I do not understand the IOCCC, can you explain it to me?
@@ -184,15 +136,12 @@ Jump to: [top](#) # The IOCCC FAQ-- How can I enter the IOCCC?
-- What is the `mkiocccentry` tool and how do I use it?
-- How do I compile `mkiocccentry` and its related tools?
-- What platform should I assume for my submission?
-- What should I put in my submission Makefile?
-- What should I put in the remarks.md file of my submission?
-
--- Is there a way to not have to re-enter the same information, when making a change to my submission?
-- May I use a different source or compiled filename than prog.c or prog?
-- What are the IOCCC best practices for using markdown?
-- How do I report bugs in an `mkiocccentry` tool?
-
--- What is the best way to ask a question about the IOCCC rules, guideline and tools?
-- How can I comment or make a suggestion on IOCCC rules, guidelines and tools?
-- Are there any compiler warnings that I should not worry about?
-- What types of entries have been frequently submitted to the IOCCC?
-- How did an entry that breaks the size rule 2 win the IOCCC?
-- How many submissions do the judges receive for a given IOCCC?
-- How much time does it take to judge the contest?
-- How many judging rounds do you have?
-- Why do some IOCCC entries receive the Grand Prize or Best of Show award?
-- How are winning IOCCC entries announced?
-- Why don't you publish submissions that do not win?
-
--- What sort of checks does the mkiocccentry tool perform?
-- How can I validate my submission tarball?
-- What is the `fnamchk` tool?
-- How can I validate my `.auth.json` and/or `.info.json` files?
-- What is a `.auth.json` file?
-- What is a `.info.json` file?
-- What is an `author handle`?
-- What is an `author_handle.json` file and how are they used?
-- How can I find my author handle?
-- What is an `entry_id`?
-- What is a `.entry.json` file and how is it used?
-- How can I validate any JSON document?
-
--- What Makefile rules are available to build or clean up IOCCC entries?
-- What kind of make(1) compatibility does the IOCCC support and will it support other kinds?
-
--- How do I compile and run an IOCCC entry that requires X11?
-- How do I compile and install SDL1 or SDL2 for entries that require it?
-- How do I compile and install (n)curses for entries that require it?
-- How do I compile and run an IOCCC entry that requires sound?
-- How do I compile and install tcpserver for entries that require it?
-- How do I compile and install netpbm for entries that require it?
-- How do I compile and install libjpeg-turbo for entries that require it?
-- How do I compile and install ImageMagick for entries that require it?
-- How do I compile and install OpenGL for entries that require it?
-- How do I download individual winning entries or all winning entries of a given year?
-- How do I compile and install zlib for IOCCC entries that require it?
-- How do I install Ruby for entries that require it?
-- How do I install rake for entries that require it?
-
--- Why don't certain IOCCC entries compile?
-- Why does clang or gcc fail to compile some IOCCC entries?
-- Why do some IOCCC entries fail to compile under macOS?
-- Why do Makefiles use -Weverything with clang?
-
--- What are `try.sh` and `try.alt.sh` scripts and why should I use them?
-- An IOCCC entry messed up my terminal application, how do I fix this?
-- Why does an IOCCC entry fail to run on my 64-bit system?
-- How do I find out how to send interrupt/EOF etc. for entries that require it?
-- Why does an IOCCC entry fail to compile and/or fail to run?
-
--- How can I find out what was changed in an IOCCC entry source code?
-- Why were some calls to the libc function gets(3) changed to use fgets(3)?
-- Why do author remarks sometimes not match the source and/or why are there
-other inconsistencies with the original entry?
-- How can I help the IOCCC?
-- Is there a list of known bugs and (mis)features of IOCCC entries?
-- How can I submit a fix to an IOCCC entry?
-- How do I make a pull request to the GitHub repo?
-- How can I report an IOCCC website problem?
-- How can I submit a fix to the IOCCC website?
-- How can I correct or update an IOCCC author's information?
-- What should I do if I find a broken or wrong web link?
-- How can I support the IOCCC?
-- I deobfuscated some entry code, may I contribute the source?
-- How do I report a bug in an IOCCC entry?
-
--- May I mirror the IOCCC website?
-- May I use parts of the IOCCC in an article, book, newsletter, or instructional material?
-- Why do you sometimes use the first person plural?
-- What is the purpose of the `.top`, `.allyear`, `.year` and `.path` files?
-- What is the current meaning of the IOCCC terms Author, Entry, and Submission?
-- Am I allowed to use IOCCC content?
-- What is Mastodon and why does IOCCC use it?
-- How do I set certain tabstops for viewing source code in vi(m)?
-- How do the menus on the website work and what can I do if they don't work?
-- How do I find more information about a winning author of an entry?
-- What is this cb tool that is mentioned in the IOCCC?
-
--- How did the IOCCC get started?
-- Why are some years missing IOCCC entries?
-- What is the history of the IOCCC website?
-- How has the IOCCC size limit rule changed over the years?
-- What is the **Great Fork Merge**?
-- What is an IOCCC BOF?
-- I do not understand the IOCCC, can you explain it to me?
-
---
## Section 0: Entering the IOCCC: the bare minimum you need to know
Jump to: [top](#)
-
--
### Q: How can I enter the IOCCC?
@@ -321,8 +270,6 @@ for an announcement of the availability of the **IOCCC submit server**.
Jump to: [top](#)
-
--
### Q: What is the `mkiocccentry` tool and how do I use it?
@@ -381,9 +328,7 @@ submission _as well as author details_ (that will only be looked at if the
submission wins), run some tests and run a number of other tools, as already
mentioned and as described below.
-
--
### Q: How do I compile `mkiocccentry` and its related tools?
@@ -407,9 +352,7 @@ See also the
for more up to date information on downloading, compiling, and related FAQ information.
Jump to: [top](#)
-
--
@@ -425,9 +368,7 @@ or [later SUS](https://unix.org/online.html).
Jump to: [top](#)
-
--
### Q: What should I put in my submission Makefile?
@@ -460,9 +401,7 @@ command that is compatible with GNU Make version 3.81.
Jump to: [top](#)
-
--
@@ -515,14 +454,12 @@ this is not clear!
Jump to: [top](#)
-
--
### Q: What is a `.auth.json` file?
@@ -794,8 +731,6 @@ FAQ on "[validating JSON documents](#validating_json)".
Jump to: [top](#)
-
--
### Q: What is a `.info.json` file?
@@ -1241,8 +1176,6 @@ FAQ on "[validating JSON documents](#validating_json)".
Jump to: [top](#)
-
--
### Q: How can I validate any JSON document?
@@ -1293,8 +1226,6 @@ the tool.
Jump to: [top](#)
-
--
### Q: How can I validate my `.auth.json` and/or `.info.json` files?
@@ -1349,16 +1280,13 @@ submission manually then you would be violating [Rule
Jump to: [top](#)
-
--
## Section 1: Entering the IOCCC: more help and details
Jump to: [top](#)
- -
### Q: Is there a way to not have to re-enter the same information, when making a change to my submission?
@@ -1385,9 +1313,7 @@ To make use of the answers file, use the `-i answers` option like:
Jump to: [top](#)
-
--
### Q: May I use a different source or compiled filename than prog.c or prog?
@@ -1443,9 +1369,7 @@ For example:
Jump to: [top](#)
-
--
### Q: What are the IOCCC best practices for using markdown?
@@ -1468,9 +1392,7 @@ See also [CommonMark Spec](https://spec.commonmark.org/current/).
Jump to: [top](#)
-
--
### Q: How do I report bugs in an `mkiocccentry` tool?
@@ -1487,12 +1409,9 @@ in the [mkiocccentry repo](https://github.com/ioccc-src/mkiocccentry).
Jump to: [top](#)
-
-
--
## Section 2: IOCCC Judging process
@@ -1500,7 +1419,6 @@ Jump to: [top](#)
Jump to: [top](#)
- -
### Q: What is the best way to ask a question about the IOCCC rules, guideline and tools?
@@ -1560,9 +1478,7 @@ FAQ on "[rules, guidelines, tools feedback](#feedback)".
Jump to: [top](#)
-
--
### Q: How can I comment or make a suggestion on IOCCC rules, guidelines and tools?
@@ -1590,10 +1506,8 @@ discussion](https://github.com/ioccc-src/mkiocccentry/discussions/new/choose).
Jump to: [top](#)
-
--
### Q: How many submissions do the judges receive for a given IOCCC?
@@ -1604,9 +1518,7 @@ By tradition, we do not say.
Jump to: [top](#)
-
--
### Q: What types of entries have been frequently submitted to the IOCCC?
@@ -1740,9 +1652,7 @@ of the same theme.
Jump to: [top](#)
-
--
### Q: Why don't you publish submissions that do not win?
@@ -1755,8 +1665,6 @@ entries that do not win on their web page for everyone to see.
Jump to: [top](#)
-
--
### Q: How much time does it take to judge the contest?
@@ -1779,8 +1687,6 @@ for more information.
Jump to: [top](#)
-
--
### Q: How many judging rounds do you have?
@@ -1799,8 +1705,6 @@ certainly more than 3.
Jump to: [top](#)
-
--
@@ -1848,8 +1752,6 @@ more other entries that came in close behind.
Jump to: [top](#)
-
--
@@ -1883,18 +1785,14 @@ winning entries page](years.html). This is done by updating this repo.
Jump to: [top](#)
-
--
## Section 3: The mkiocccentry toolkit: finer details
Jump to: [top](#)
-
--
### Q: What sort of checks does the mkiocccentry tool perform?
@@ -1981,8 +1879,6 @@ See also the [Guidelines](next/guidelines.html) and the [Rules](next/rules.html)
(and in particular [Rule 17](next/rules.html#rule17)).
Jump to: [top](#)
-
--
@@ -2022,8 +1918,6 @@ code](https://github.com/ioccc-src/mkiocccentry/blob/master/txzchk.c).
Jump to: [top](#)
-
--
### Q: FAQ 0.14 - What is the `fnamchk` tool?
@@ -2052,19 +1946,15 @@ for more information.
Jump to: [top](#)
-
--
## Section 4: Compiling IOCCC entries
Jump to: [top](#)
-
--
### Q: What Makefile rules are available to build or clean up IOCCC entries?
@@ -2129,8 +2019,6 @@ were to do something like `make CC=gcc=mp-12` it would register as `gcc`.
Jump to: [top](#)
-
--
### Q: Why don't certain IOCCC entries compile?
@@ -2173,8 +2061,6 @@ compiles does not mean it will run on your specific system.
Jump to: [top](#)
-
--
### Q: Why does an IOCCC entry fail to run on my 64-bit system?
@@ -2212,8 +2098,6 @@ for more information about pull requests.
Jump to: [top](#)
-
-