diff --git a/faq.html b/faq.html index 7b4168dd4..219e975ba 100644 --- a/faq.html +++ b/faq.html @@ -389,15 +389,14 @@
This is FAQ version 28.1.1 2024-10-21.
+This is FAQ version 28.1.2 2024-10-21.
mkiocccentry tool, how do I obtain it and how do I use it?mkiocccentry and its related tools?Jump to: top
mkiocccentry tool, how do I obtain it and how do I use it?This tool comes from the mkiocccentry repo and it is required that you use it to package your submission. Not doing so puts you at a great risk of @@ -623,11 +626,22 @@ have an mkiocccentry tool directory:
cd mkiocccentry
git fetch
git rebase
+Once you’ve done this, change to the mkiocccentry directory and run
+make clobber all to compile the tools.
+See the
+FAQ on “compiling mkiocccentry”
+at the mkiocccentry repo if you need more help.
The mkiocccentry tool first gathers your source
-code, your Makefile, your remarks, other information about your submission,
-information about the author (or authors) and then runs a lot of tests before (if
+code, your Makefile, your remarks, any other data files you wish to provide (up
+to a maximum, including the mandatory files, defined in
+limit_ioccc.h
+as MAX_FILE_COUNT) and other information about your submission,
+information about the author (or authors), and then runs a lot of tests before (if
all is OK) forming your tarball. After this is done it will additionally run the
-txzchk(1) tool (which runs the fnamchk(1) tool) on the submission tarball.
txzchk(1) tool (which runs the fnamchk(1) tool) on the submission tarball.
+The tool chkentry(1) will also be run, before creating the tarball. See the
+FAQ on “chkentry”
+for more information.
See the
FAQ on “submitting to the IOCCC”
for details on how to register for the IOCCC and how to obtain mkiocccentry.
Jump to: top
-mkiocccentry and its related tools?After you -download the mkiocccentry -repo by -running:
-git clone https://github.com/ioccc-src/mkiocccentry.git
-or downloading the zip file, you should change to the mkiocccentry directory
-so you can compile the tools by running make clobber all. See the
-FAQ on “obtaining
-mkiocccentry
-and the
-FAQ on”compiling mkiocccentry”
-at the mkiocccentry repo.
See also the mkiocccentry repo FAQ for more up to date information on downloading, compiling, and related FAQ information.
@@ -686,7 +682,7 @@ for more up to date information on downloading, compiling, and related FAQ inforJump to: top
We recommend starting with the sample @@ -3770,9 +3766,9 @@ provided by the author and any other file in the winning entry, found under the entry’s subdirectory.
If you downloaded 1984/mullender/1984_mullender.tar.bz2, for instance, you might
then do:
cd 1984/mullender
- make everything
- ./mullender.alt cd 1984/mullender
+ make everything
+ ./mullender.altto compile all versions and then run the alternate version (if you have
a PDP-11 or VAX-11 you would be able to run the original version). For more help
on compiling entries, see also the
@@ -3813,8 +3809,8 @@ if you switched to each entry’s directory and ran make everything
If you download the 1984 tarball, i.e. 1984/1984.tar.bz2, then you might
extract it and then switch to the directory and compile everything of each
entry:
cd 1984
- make everything cd 1984
+ make everythingFor more help on compiling entries, see also the FAQ on “IOCCC Makefile rules”.
Of course in this case you can also switch to individual entries and look at the diff --git a/faq.md b/faq.md index 6e120cf6a..81cf663a6 100644 --- a/faq.md +++ b/faq.md @@ -1,15 +1,14 @@ # IOCCC FAQ Table of Contents -This is FAQ version **28.1.1 2024-10-21**. +This is FAQ version **28.1.2 2024-10-21**. ## 0. [Entering the IOCCC: the bare minimum you need to know](#enter_questions) - **Q 0.0**: How can I enter the IOCCC? - **Q 0.1**: What is the `mkiocccentry` tool, how do I obtain it and how do I use it? -- **Q 0.2**: How do I compile `mkiocccentry` and its related tools? -- **Q 0.3**: What platform should I assume for my submission? -- **Q 0.4**: What should I put in my submission Makefile? -- **Q 0.5**: What should I put in the remarks.md file of my submission? +- **Q 0.2**: What platform should I assume for my submission? +- **Q 0.3**: What should I put in my submission Makefile? +- **Q 0.4**: What should I put in the remarks.md file of my submission? ## 1. [Entering the IOCCC: more help and details](#submitting_help) @@ -271,8 +270,12 @@ Jump to: [top](#)