fix use of temp-test-ioccc
Regarding use of `temp-test-ioccc` in current repo files: We will ignore files under `tmp/` as they are going away. We will ignore files under `bin/` as they will have their default `REPO_URL` value changed during the later parts of the **Great Fork Merge**. We will ignore `*.html` files as the above changes to `bin/` tool will also change them during the later parts of the **Great Fork Merge**. We will ignore `sitemap.xml` as the it will change during the later parts of the **Great Fork Merge**. So this leaves for our consideration the files printed by this command: ```sh find * -type f ! -name '*.html' ! -name sitemap.xml ! -path 'tmp/*' ! -path 'bin/*' -print0 | xargs -0 grep -l 'temp-test-ioccc' ``` We see 5 (3 sir), 3 cases: * README.md index.md The reference to `temp-test-ioccc` will be removed when a given section goes away as part of the later parts of the **Great Fork Merge**. Nothing needs to be dome here other than to add some **XXX** comments to help remind us of what needs to be done in later parts of the **Great Fork Merge**. * bugs.md faq.md news.md var.mk The use of `temp-test-ioccc` is outside of a blob. Here `https://github.com/ioccc-src/temp-test-ioccc/` may be be replaced by `https://github.com/ioccc-src/winner/` in anticipation of the **Great Fork Merge**. There is an exception: The historic discussion abouts the history of the `temp-test-ioccc` repo needs to retain their `https://github.com/ioccc-src/temp-test-ioccc/` strings in `faq.md` and `news.md`. * 2005/sykes/README.md The markdown links that start with `https://github.com/ioccc-src/temp-test-ioccc/blob/master/` should instead start with `%%REPO_URL%%/`. After the **Great Fork Merge**, the `%%REPO_URL%%/` value will refer to `https://github.com/ioccc-src/winner/blob/master/` instead. * 2020/ferguson1/snake.1 There is not a tool to "pre-process" cat pages like there is for markdown files: no should there be. The cat page refers to a markdown file when instead it should refer to a HTML page. In this case we suggest that `https://github.com/ioccc-src/temp-test-ioccc/blob/` be replaced by `https://www.isthe.com/`, and `.md` be replaced by `.html` in anticipation of what it will need to be after the **Great Fork Merge**. * YYYY/entry_dir/*.sh The shell scripts references by the above command are "helper shell scripts. Like man pages, there is no "pre-processor" for shell scripts, nor should there be. Looking at these helper shell script files in detail: ```sh find * -name '*.sh' ! -path 'tmp/*' ! -path 'bin/*' -print0 | xargs -0 grep 'temp-test-ioccc/blob/master' ``` We see that they all make references to `faq.md#something.`. This is wrong in 2 ways: 0) They should not refer to the markdown file `faq.md` but rather to the HTML file `faq.html`. 1) They punctuate a literal string (with one exception) by adding a final period (".") to a string that requires somebody to copy and paste and exclude the final period ("."). Since these echo commands are suggesting that the user view something within the FAQ, we recommend that `echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#` be replaced by `echo "Tip: see https://www.ioccc.org/faq.html#` AND that the final period (".") be removed. Thus they too will anticipate what they will need to be after the **Great Fork Merge**.
This commit is contained in:
1 parent
7b0bd24f8e
commit
a78d78ccff
20 files changed
+79
-74
No files matched your search
+1
-1
@@ -32,5 +32,5 @@ elif [[ -S "$DSP" ]]; then
|
|||||||
./coupard > "$DSP"
|
./coupard > "$DSP"
|
||||||
else
|
else
|
||||||
echo "SoX not installed. Please install it and try again." 1>&2
|
echo "SoX not installed. Please install it and try again." 1>&2
|
||||||
echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
fi
|
fi
|
||||||
@@ -65,5 +65,5 @@ else
|
|||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "convert not found (ImageMagick not installed?)" 1>&2
|
echo "convert not found (ImageMagick not installed?)" 1>&2
|
||||||
echo "Try viewing *.svg with a graphics viewer that can view SVG files." 1>&2
|
echo "Try viewing *.svg with a graphics viewer that can view SVG files." 1>&2
|
||||||
echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#imagemagick." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#imagemagick" 1>&2
|
||||||
fi
|
fi
|
||||||
@@ -37,7 +37,7 @@ For those who fondly remember their first
|
|||||||
down memory lane ... starting with `$C000` of course!
|
down memory lane ... starting with `$C000` of course!
|
||||||
|
|
||||||
We encourage you to try and grok the obfuscated expression on [line
|
We encourage you to try and grok the obfuscated expression on [line
|
||||||
56](https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/sykes/sykes.c#L56),
|
56](%%REPO_URL%%/2005/sykes/sykes.c#L56),
|
||||||
after the C pre-processor gets finished with it!
|
after the C pre-processor gets finished with it!
|
||||||
|
|
||||||
We downloaded the [ROM](https://en.wikipedia.org/wiki/ROM_image) contents to use
|
We downloaded the [ROM](https://en.wikipedia.org/wiki/ROM_image) contents to use
|
||||||
@@ -258,13 +258,13 @@ mode. Otherwise some PET specific features are skipped during normal
|
|||||||
|
|
||||||
The main processing all happens in a heroic expression containing no
|
The main processing all happens in a heroic expression containing no
|
||||||
less than 64 ternary operators (after `cpp`) starting on [line
|
less than 64 ternary operators (after `cpp`) starting on [line
|
||||||
56](https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/sykes/sykes.c#L56).
|
56](%%REPO_URL%%/2005/sykes/sykes.c#L56).
|
||||||
This decodes the
|
This decodes the
|
||||||
[6502](https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description)
|
[6502](https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description)
|
||||||
instructions according to a table and executes them.
|
instructions according to a table and executes them.
|
||||||
|
|
||||||
The addressing mode is decoded in a similar expression starting on [line
|
The addressing mode is decoded in a similar expression starting on [line
|
||||||
53](https://github.com/ioccc-src/temp-test-ioccc/blob/master/2005/sykes/sykes.c#L53).
|
53](%%REPO_URL%%/2005/sykes/sykes.c#L53).
|
||||||
|
|
||||||
|
|
||||||
### Bugs
|
### Bugs
|
||||||
|
|||||||
+1
-1
@@ -76,7 +76,7 @@ endoh3()
|
|||||||
echo 1>&2
|
echo 1>&2
|
||||||
else
|
else
|
||||||
echo "Please install either SoX, ruby or padsp (from PulseAudio)." 1>&2
|
echo "Please install either SoX, ruby or padsp (from PulseAudio)." 1>&2
|
||||||
echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
|
|||||||
+1
-1
@@ -31,7 +31,7 @@ SOX="$(type -P sox)"
|
|||||||
|
|
||||||
if [[ -z "$SOX" && -z "$APLAY" ]]; then
|
if [[ -z "$SOX" && -z "$APLAY" ]]; then
|
||||||
echo "Missing both sox and aplay, cannot do this step." 1>&2
|
echo "Missing both sox and aplay, cannot do this step." 1>&2
|
||||||
echo "NOTE: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
elif [[ -n "$SOX" ]]; then
|
elif [[ -n "$SOX" ]]; then
|
||||||
echo "$ echo -n ' MENE MENE TEKEL UPHARSIN ' | ./prog | \
|
echo "$ echo -n ' MENE MENE TEKEL UPHARSIN ' | ./prog | \
|
||||||
$SOX -t raw -c 1 -r 44100 -L -e floating-point -b 32 \
|
$SOX -t raw -c 1 -r 44100 -L -e floating-point -b 32 \
|
||||||
|
|||||||
+2
-2
@@ -40,12 +40,12 @@ elif [[ -n "$PNGTOPNM" && -n "$PNMSCALE" && -n "$CJPEG" ]]; then
|
|||||||
else
|
else
|
||||||
if [[ -z "$PNGTOPAM" || -z "$PNGTOPNM" || "$PNMSCALE" ]]; then
|
if [[ -z "$PNGTOPAM" || -z "$PNGTOPNM" || "$PNMSCALE" ]]; then
|
||||||
echo "Cannot find pngtopam(1) or pnmscale(1). Try installing netpbm first." 1>&2
|
echo "Cannot find pngtopam(1) or pnmscale(1). Try installing netpbm first." 1>&2
|
||||||
echo "See https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#netpbm" 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#netpbm" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
fi
|
fi
|
||||||
if [[ -z "$CJPEG" ]]; then
|
if [[ -z "$CJPEG" ]]; then
|
||||||
echo "Cannot find cjpeg. Try installing libjpeg-turbo." 1>&2
|
echo "Cannot find cjpeg. Try installing libjpeg-turbo." 1>&2
|
||||||
echo "See https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#libjpeg." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#libjpeg" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
+1
-1
@@ -35,6 +35,6 @@ if [[ -n "$PLAY" ]]; then
|
|||||||
echo 1>&2
|
echo 1>&2
|
||||||
else
|
else
|
||||||
echo "play(1) from SoX not installed." 1>&2
|
echo "play(1) from SoX not installed." 1>&2
|
||||||
echo "NOTE: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
fi
|
fi
|
||||||
|
|
||||||
@@ -77,7 +77,7 @@ you grow to the full size!
|
|||||||
Size to grow every time you eat a bug.
|
Size to grow every time you eat a bug.
|
||||||
Default 5; can be negative.
|
Default 5; can be negative.
|
||||||
"Negativity" creates for fun gameplay modes with enough creativity.
|
"Negativity" creates for fun gameplay modes with enough creativity.
|
||||||
See \fB\<https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/gameplay.md\>\fP for some examples.
|
See \fB\<https://www.ioccc.org/2020/ferguson1/gameplay.html\>\fP for some examples.
|
||||||
\fIplay.sh\fP allows you to reconfigure the colours and play different pre\-configured gameplay modes.
|
\fIplay.sh\fP allows you to reconfigure the colours and play different pre\-configured gameplay modes.
|
||||||
.TQ
|
.TQ
|
||||||
.B SHED
|
.B SHED
|
||||||
@@ -109,7 +109,7 @@ or
|
|||||||
See
|
See
|
||||||
.I play.sh
|
.I play.sh
|
||||||
and
|
and
|
||||||
.I \<https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/gameplay.md\>
|
.I \<https://www.ioccc.org/2020/ferguson1/gameplay.html\>
|
||||||
for examples.
|
for examples.
|
||||||
.sp
|
.sp
|
||||||
.RS
|
.RS
|
||||||
@@ -229,7 +229,7 @@ The shed snakeskin is not an obstacle but walls can be and so can the snake itse
|
|||||||
Also snakes grow by moulting (technical term for shedding) so when the snake leaves its snakeskin behind it really ought to grow but instead it shrinks; this means negative shedding ought to have the snake grow and positive shedding have the snake - what?
|
Also snakes grow by moulting (technical term for shedding) so when the snake leaves its snakeskin behind it really ought to grow but instead it shrinks; this means negative shedding ought to have the snake grow and positive shedding have the snake - what?
|
||||||
It's a misnomer: it took fewer bytes and the negative shedding is a positive consequence of unsigned arithmetic.
|
It's a misnomer: it took fewer bytes and the negative shedding is a positive consequence of unsigned arithmetic.
|
||||||
.PP
|
.PP
|
||||||
On a more serious note see \fB\<https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/bugs.md\>\fP.
|
On a more serious note see \fB\<https://www.ioccc.org/2020/ferguson1/bugs.html\>\fP.
|
||||||
.SH EXAMPLES
|
.SH EXAMPLES
|
||||||
.PP
|
.PP
|
||||||
Test your terminal capabilities and get other various data (based on dimensions of terminal, growth size, size and max size as specified i.e. you can pass in the variables \fBLINES\fP, \fBCOLUMNS\fP, \fBMAXSIZE\fP, \fBGROW\fP and \fBSIZE\fp):
|
Test your terminal capabilities and get other various data (based on dimensions of terminal, growth size, size and max size as specified i.e. you can pass in the variables \fBLINES\fP, \fBCOLUMNS\fP, \fBMAXSIZE\fP, \fBGROW\fP and \fBSIZE\fp):
|
||||||
@@ -279,7 +279,7 @@ That will compile the game to be the colours you select and then enable cannibal
|
|||||||
.PP
|
.PP
|
||||||
For many more gameplay information, modes and features check:
|
For many more gameplay information, modes and features check:
|
||||||
.br
|
.br
|
||||||
\fB\<https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/gameplay.md\>\fP
|
\fB\<https://www.ioccc.org/2020/ferguson1/gameplay.html\>\fP
|
||||||
and for an interactive script that prompts for some of those modes see the \fIplay.sh\fP script.
|
and for an interactive script that prompts for some of those modes see the \fIplay.sh\fP script.
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Written by Cody Boone Ferguson for IOCCC 2020 (the 27th IOCCC).
|
Written by Cody Boone Ferguson for IOCCC 2020 (the 27th IOCCC).
|
||||||
|
|||||||
+3
-3
@@ -25,7 +25,7 @@ if [[ -z "$PLAY" ]]; then
|
|||||||
echo "Note: cannot find play(1) or aplay(1). Will not play sounds for you. Try installing" 1>&2
|
echo "Note: cannot find play(1) or aplay(1). Will not play sounds for you. Try installing" 1>&2
|
||||||
echo "SoX. You will have to play the WAV output manually, sorry." 1>&2
|
echo "SoX. You will have to play the WAV output manually, sorry." 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
@@ -40,7 +40,7 @@ if [[ -n "$PLAY" ]]; then
|
|||||||
else
|
else
|
||||||
echo "Please play pi.wav in an audio player that can play WAV files." 1>&2
|
echo "Please play pi.wav in an audio player that can play WAV files." 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
fi
|
fi
|
||||||
|
|
||||||
@@ -60,7 +60,7 @@ else
|
|||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Please play jenny.wav with an audio player that can play WAV files."
|
echo "Please play jenny.wav with an audio player that can play WAV files."
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Tip: see https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#sox." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#sox" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
read -r -n 1 -p "Press any key to convert 10666-28 ('IOCCC-28'): "
|
read -r -n 1 -p "Press any key to convert 10666-28 ('IOCCC-28'): "
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
|
|||||||
@@ -42,7 +42,7 @@ convert_error()
|
|||||||
{
|
{
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Warning: $CONVERT failed to generate out.gif. Is $CONVERT convert(1) from ImageMagick?" 1>&2
|
echo "Warning: $CONVERT failed to generate out.gif. Is $CONVERT convert(1) from ImageMagick?" 1>&2
|
||||||
echo "See: https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#imagemagick." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#imagemagick" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Tip: if you have it in a different path, try: CONVERT=path ./try.sh" 1>&2
|
echo "Tip: if you have it in a different path, try: CONVERT=path ./try.sh" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
@@ -51,7 +51,7 @@ convert_error()
|
|||||||
if [[ -z "$CONVERT" || ! -f "$CONVERT" || ! -x "$CONVERT" ]]; then
|
if [[ -z "$CONVERT" || ! -f "$CONVERT" || ! -x "$CONVERT" ]]; then
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Could not fine convert(1) from ImageMagick." 1>&2
|
echo "Could not fine convert(1) from ImageMagick." 1>&2
|
||||||
echo "See: https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#imagemagick." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#imagemagick" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
else
|
else
|
||||||
"$CONVERT" -delay 10 -dither none -loop 0 "${list[@]}" +map "$output"
|
"$CONVERT" -delay 10 -dither none -loop 0 "${list[@]}" +map "$output"
|
||||||
|
|||||||
@@ -21,7 +21,7 @@ convert_error()
|
|||||||
{
|
{
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Warning: $CONVERT failed to generate out.gif. Is $CONVERT convert(1) from ImageMagick?" 1>&2
|
echo "Warning: $CONVERT failed to generate out.gif. Is $CONVERT convert(1) from ImageMagick?" 1>&2
|
||||||
echo "See: https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#imagemagick." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#imagemagick" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Tip: if you have it in a different path, try: CONVERT=path ./try.sh" 1>&2
|
echo "Tip: if you have it in a different path, try: CONVERT=path ./try.sh" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
@@ -78,6 +78,6 @@ if [[ -n "$CONVERT" ]]; then
|
|||||||
else
|
else
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
echo "Could not fine convert(1) from ImageMagick." 1>&2
|
echo "Could not fine convert(1) from ImageMagick." 1>&2
|
||||||
echo "See: https://github.com/ioccc-src/temp-test-ioccc/blob/master/faq.md#imagemagick." 1>&2
|
echo "Tip: visit: https://www.ioccc.org/faq.html#imagemagick" 1>&2
|
||||||
echo 1>&2
|
echo 1>&2
|
||||||
fi
|
fi
|
||||||
+3
-3
@@ -382,6 +382,7 @@
|
|||||||
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
||||||
|
|
||||||
<!-- BEFORE: 1st line of markdown file: README.md -->
|
<!-- BEFORE: 1st line of markdown file: README.md -->
|
||||||
|
<!-- XXX - This entire section goes away during the final stages of the Great Fork Merge -->
|
||||||
<h3 id="this-is-not-the-official-ioccc-web-site">This is NOT the official IOCCC web site!</h3>
|
<h3 id="this-is-not-the-official-ioccc-web-site">This is NOT the official IOCCC web site!</h3>
|
||||||
<p>Please visit <a href="https://www.ioccc.org">www.ioccc.org</a> for the official <strong>IOCCC</strong> web site.</p>
|
<p>Please visit <a href="https://www.ioccc.org">www.ioccc.org</a> for the official <strong>IOCCC</strong> web site.</p>
|
||||||
<p>Please do NOT bookmark or link to this <a href="https://ioccc-src.github.io/temp-test-ioccc/">experimental web site</a>.</p>
|
<p>Please do NOT bookmark or link to this <a href="https://ioccc-src.github.io/temp-test-ioccc/">experimental web site</a>.</p>
|
||||||
@@ -392,9 +393,8 @@ broken links, typos and other problems. If you wish to recommend
|
|||||||
changes (understanding that things may be rapidly changing out from
|
changes (understanding that things may be rapidly changing out from
|
||||||
under your copy), then consider making pull requests against the
|
under your copy), then consider making pull requests against the
|
||||||
temp-test-ioccc GitHub repo.</p>
|
temp-test-ioccc GitHub repo.</p>
|
||||||
<p>XXX - The text from the top down to the <em>What follows is the actual README.md file</em>
|
<h3 id="what-follows-is-the-actual-readme.md-file">What follows is the actual README.md file</h3>
|
||||||
line will be removed when this web site becomes official - XXX</p>
|
<!-- XXX - remove down to here in the final stages of the Great Fork Merge -->
|
||||||
<h2 id="what-follows-is-the-actual-readme.md-file---remove-from-top-down-through-this-line---xxx">What follows is the actual README.md file - Remove from top down through this line - XXX</h2>
|
|
||||||
<h1 id="the-international-obfuscated-c-code-contest">The International Obfuscated C Code Contest</h1>
|
<h1 id="the-international-obfuscated-c-code-contest">The International Obfuscated C Code Contest</h1>
|
||||||
<h2 id="obfuscate-verb-with-object"><strong>Obfuscate</strong> | <em>verb</em> [with object]</h2>
|
<h2 id="obfuscate-verb-with-object"><strong>Obfuscate</strong> | <em>verb</em> [with object]</h2>
|
||||||
<ul>
|
<ul>
|
||||||
|
|||||||
@@ -1,3 +1,4 @@
|
|||||||
|
<!-- XXX - This entire section goes away during the final stages of the Great Fork Merge -->
|
||||||
### This is NOT the official IOCCC web site!
|
### This is NOT the official IOCCC web site!
|
||||||
|
|
||||||
Please visit [www.ioccc.org](https://www.ioccc.org) for the official **IOCCC** web site.
|
Please visit [www.ioccc.org](https://www.ioccc.org) for the official **IOCCC** web site.
|
||||||
@@ -14,13 +15,11 @@ changes (understanding that things may be rapidly changing out from
|
|||||||
under your copy), then consider making pull requests against the
|
under your copy), then consider making pull requests against the
|
||||||
temp-test-ioccc GitHub repo.
|
temp-test-ioccc GitHub repo.
|
||||||
|
|
||||||
XXX - The text from the top down to the _What follows is the actual README.md file_
|
|
||||||
line will be removed when this web site becomes official - XXX
|
### What follows is the actual README.md file
|
||||||
|
|
||||||
|
|
||||||
## What follows is the actual README.md file - Remove from top down through this line - XXX
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- XXX - remove down to here in the final stages of the Great Fork Merge -->
|
||||||
# The International Obfuscated C Code Contest
|
# The International Obfuscated C Code Contest
|
||||||
|
|
||||||
## **Obfuscate** | *verb* [with object]
|
## **Obfuscate** | *verb* [with object]
|
||||||
|
|||||||
@@ -391,10 +391,10 @@ attempt to port older code to more modern environments introduced bugs.</p>
|
|||||||
<p>The following is a known list of <strong>BUGS and (mis)FEATURES</strong> in IOCCC entries.</p>
|
<p>The following is a known list of <strong>BUGS and (mis)FEATURES</strong> in IOCCC entries.</p>
|
||||||
<p>Can you fix/improve entries not under the INABIAF (it’s not a bug it’s a
|
<p>Can you fix/improve entries not under the INABIAF (it’s not a bug it’s a
|
||||||
feature)? You are <strong>VERY WELCOME</strong> to try.</p>
|
feature)? You are <strong>VERY WELCOME</strong> to try.</p>
|
||||||
<p>As far as how to help: please submit your fixes in a <a href="https://github.com/ioccc-src/temp-test-ioccc/pulls">GitHub pull
|
<p>As far as how to help: please submit your fixes in a <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull
|
||||||
request</a> (with ONE PULL
|
request</a> (with ONE PULL
|
||||||
REQUEST <em>PER</em> FIX, please)!</p>
|
REQUEST <em>PER</em> FIX, please)!</p>
|
||||||
<p>We will be <strong>happy to credit anyone who submits successful <a href="https://github.com/ioccc-src/temp-test-ioccc/pulls">GitHub pull
|
<p>We will be <strong>happy to credit anyone who submits successful <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull
|
||||||
requests</a></strong> in the
|
requests</a></strong> in the
|
||||||
<a href="thanks-for-help.html">thanks</a> file. If you’re the author of an entry
|
<a href="thanks-for-help.html">thanks</a> file. If you’re the author of an entry
|
||||||
that win the IOCCC, we will add a link to your winning entries in the file
|
that win the IOCCC, we will add a link to your winning entries in the file
|
||||||
@@ -3300,7 +3300,7 @@ for now we wish everyone a happy new year!</p>
|
|||||||
<p>We hope this document was of use to you in determining which entries are known
|
<p>We hope this document was of use to you in determining which entries are known
|
||||||
to have a problem, what entries are known to have features that are not bugs and
|
to have a problem, what entries are known to have features that are not bugs and
|
||||||
so on. We also thank you for going through this document and, if you propose any
|
so on. We also thank you for going through this document and, if you propose any
|
||||||
fixes] via a <a href="https://github.com/ioccc-src/temp-test-ioccc/pulls">GitHub pull
|
fixes] via a <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull
|
||||||
request</a> or otherwise, we
|
request</a> or otherwise, we
|
||||||
thank you as well for the help! We will happily add you to the
|
thank you as well for the help! We will happily add you to the
|
||||||
<a href="thanks-for-help.html">thanks</a> file as well.</p>
|
<a href="thanks-for-help.html">thanks</a> file as well.</p>
|
||||||
|
|||||||
@@ -12,11 +12,11 @@ Can you fix/improve entries not under the INABIAF (it's not a bug it's a
|
|||||||
feature)? You are **VERY WELCOME** to try.
|
feature)? You are **VERY WELCOME** to try.
|
||||||
|
|
||||||
As far as how to help: please submit your fixes in a [GitHub pull
|
As far as how to help: please submit your fixes in a [GitHub pull
|
||||||
request](https://github.com/ioccc-src/temp-test-ioccc/pulls) (with ONE PULL
|
request](https://github.com/ioccc-src/winner/pulls) (with ONE PULL
|
||||||
REQUEST *PER* FIX, please)!
|
REQUEST *PER* FIX, please)!
|
||||||
|
|
||||||
We will be **happy to credit anyone who submits successful [GitHub pull
|
We will be **happy to credit anyone who submits successful [GitHub pull
|
||||||
requests](https://github.com/ioccc-src/temp-test-ioccc/pulls)** in the
|
requests](https://github.com/ioccc-src/winner/pulls)** in the
|
||||||
[thanks](thanks-for-help.html) file. If you're the author of an entry
|
[thanks](thanks-for-help.html) file. If you're the author of an entry
|
||||||
that win the IOCCC, we will add a link to your winning entries in the file
|
that win the IOCCC, we will add a link to your winning entries in the file
|
||||||
(if you're not an author, we can add a link to your GitHub page or personal
|
(if you're not an author, we can add a link to your GitHub page or personal
|
||||||
@@ -4231,7 +4231,7 @@ We hope this document was of use to you in determining which entries are known
|
|||||||
to have a problem, what entries are known to have features that are not bugs and
|
to have a problem, what entries are known to have features that are not bugs and
|
||||||
so on. We also thank you for going through this document and, if you propose any
|
so on. We also thank you for going through this document and, if you propose any
|
||||||
fixes] via a [GitHub pull
|
fixes] via a [GitHub pull
|
||||||
request](https://github.com/ioccc-src/temp-test-ioccc/pulls) or otherwise, we
|
request](https://github.com/ioccc-src/winner/pulls) or otherwise, we
|
||||||
thank you as well for the help! We will happily add you to the
|
thank you as well for the help! We will happily add you to the
|
||||||
[thanks](thanks-for-help.html) file as well.
|
[thanks](thanks-for-help.html) file as well.
|
||||||
|
|
||||||
|
|||||||
@@ -382,7 +382,7 @@
|
|||||||
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
||||||
|
|
||||||
<!-- BEFORE: 1st line of markdown file: faq.md -->
|
<!-- BEFORE: 1st line of markdown file: faq.md -->
|
||||||
<h1 id="faq-table-of-contents">FAQ Table of Contents <!-- XXX - Change the references from _temp-test-ioccc_ to _winners_ when these fixes are merged. --></h1>
|
<h1 id="faq-table-of-contents">FAQ Table of Contents</h1>
|
||||||
<h2 id="section-0---submitting-entries-to-a-new-ioccc">Section 0 - <a href="#faq0">Submitting entries to a new IOCCC</a></h2>
|
<h2 id="section-0---submitting-entries-to-a-new-ioccc">Section 0 - <a href="#faq0">Submitting entries to a new IOCCC</a></h2>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#faq0_0">0.0 - How may I submit to the IOCCC?</a></li>
|
<li><a href="#faq0_0">0.0 - How may I submit to the IOCCC?</a></li>
|
||||||
@@ -708,10 +708,10 @@ rules</a>, <a href="next/guidelines.html">IOCCC guidelines</a>
|
|||||||
and on the <a href="https://github.com/ioccc-src/mkiocccentry">IOCCC mkiocccentry tools</a>.</p>
|
and on the <a href="https://github.com/ioccc-src/mkiocccentry">IOCCC mkiocccentry tools</a>.</p>
|
||||||
<p>To comment on the <a href="next/rules.html">IOCCC rules</a> or the
|
<p>To comment on the <a href="next/rules.html">IOCCC rules</a> or the
|
||||||
<a href="next/guidelines.html">IOCCC guidelines</a> please view the
|
<a href="next/guidelines.html">IOCCC guidelines</a> please view the
|
||||||
<a href="https://github.com/ioccc-src/temp-test-ioccc/discussions">GitHub discussions for this repo</a>.
|
<a href="https://github.com/ioccc-src/winner/discussions">GitHub discussions for this repo</a>.
|
||||||
If there is an on-going discussion that seems relevant to what you
|
If there is an on-going discussion that seems relevant to what you
|
||||||
have to say, consider adding comments to that particular discussion.
|
have to say, consider adding comments to that particular discussion.
|
||||||
Otherwise consider opening a <a href="https://github.com/ioccc-src/temp-test-ioccc/discussions/new/choose">new IOCCC repo
|
Otherwise consider opening a <a href="https://github.com/ioccc-src/winner/discussions/new/choose">new IOCCC repo
|
||||||
discussion</a>.</p>
|
discussion</a>.</p>
|
||||||
<p>To comment on <a href="https://github.com/ioccc-src/mkiocccentry">IOCCC mkiocccentry tools</a>,
|
<p>To comment on <a href="https://github.com/ioccc-src/mkiocccentry">IOCCC mkiocccentry tools</a>,
|
||||||
please view the <a href="https://github.com/ioccc-src/mkiocccentry/discussions">mkiocccentry repo discussions</a>.
|
please view the <a href="https://github.com/ioccc-src/mkiocccentry/discussions">mkiocccentry repo discussions</a>.
|
||||||
@@ -946,7 +946,7 @@ files) that is more consistent across IOCCC years.</li>
|
|||||||
<li>Generating HTML content from markdown files and JSON data files via a <a href="bin/index.html">set of
|
<li>Generating HTML content from markdown files and JSON data files via a <a href="bin/index.html">set of
|
||||||
tools and scripts</a>.</li>
|
tools and scripts</a>.</li>
|
||||||
<li>Setting up a system whereby authors of IOCCC entries may update their own
|
<li>Setting up a system whereby authors of IOCCC entries may update their own
|
||||||
contact information via a <a href="https://github.com/ioccc-src/temp-test-ioccc/pulls">GitHub pull
|
contact information via a <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull
|
||||||
request</a>.</li>
|
request</a>.</li>
|
||||||
<li>Setting up to generate the top level <a href="years.html">years.html</a> file via the
|
<li>Setting up to generate the top level <a href="years.html">years.html</a> file via the
|
||||||
<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/bin/gen-years.sh">gen-years.sh</a> tool.</li>
|
<a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/bin/gen-years.sh">gen-years.sh</a> tool.</li>
|
||||||
@@ -1656,7 +1656,7 @@ known and we are looking for someone to attempt to fix it.</p>
|
|||||||
that you may wish to try.</p>
|
that you may wish to try.</p>
|
||||||
<p>It also possible that you may have discovered a bug in an winning IOCCC
|
<p>It also possible that you may have discovered a bug in an winning IOCCC
|
||||||
entry. If so, you are invited to try an fix the IOCCC entry and
|
entry. If so, you are invited to try an fix the IOCCC entry and
|
||||||
submit that fix by way of a <a href="https://github.com/ioccc-src/temp-test-ioccc/pulls">GitHub pull
|
submit that fix by way of a <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull
|
||||||
request</a>.
|
request</a>.
|
||||||
Please see <a href="#fix_an_entry">FAQ 5.2</a> for how to submit a fix to an IOCCC entry.</p>
|
Please see <a href="#fix_an_entry">FAQ 5.2</a> for how to submit a fix to an IOCCC entry.</p>
|
||||||
<div id="faq3_14">
|
<div id="faq3_14">
|
||||||
@@ -2045,7 +2045,7 @@ section may offer you important fixing clues.</p>
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<p>We do not ‘maintain’ the contest entries as such. The code is made available on an ‘AS
|
<p>We do not ‘maintain’ the contest entries as such. The code is made available on an ‘AS
|
||||||
IS’ basis. If you have a FIX for an entry, we suggest that you submit your fixes in a <a href="https://github.com/ioccc-src/temp-test-ioccc/pulls">GitHub pull
|
IS’ basis. If you have a FIX for an entry, we suggest that you submit your fixes in a <a href="https://github.com/ioccc-src/winner/pulls">GitHub pull
|
||||||
request</a> as we welcome pull requests that have a
|
request</a> as we welcome pull requests that have a
|
||||||
minimal impact on the entry while improving the portability, functionality, and/or addressing known problems.</p>
|
minimal impact on the entry while improving the portability, functionality, and/or addressing known problems.</p>
|
||||||
<p>If you do submit a pull request, we ask that each pull request address just one IOCCC entry at a time.</p>
|
<p>If you do submit a pull request, we ask that each pull request address just one IOCCC entry at a time.</p>
|
||||||
@@ -2728,8 +2728,8 @@ have to be logged into your account.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<li><a href="#creating-a-github-account">Creating a GitHub account</a></li>
|
<li><a href="#creating-a-github-account">Creating a GitHub account</a></li>
|
||||||
<li><a href="#installing-an-ssh-key">Installing an ssh key to GitHub</a></li>
|
<li><a href="#installing-an-ssh-key">Installing an ssh key to GitHub</a></li>
|
||||||
<li><a href="#forking-the-temp-test-ioccc-repo">Forking the temp-test-ioccc repo</a></li>
|
<li><a href="#forking-the-ioccc-winner-repo">Forking the IOCCC winner repo</a></li>
|
||||||
<li><a href="#cloning-the-temp-test-ioccc-repo">Cloning the temp-test-ioccc repo</a></li>
|
<li><a href="#cloning-the-ioccc-winner-repo">Cloning the IOCCC winner repo</a></li>
|
||||||
<li><a href="#making-changes-fixes-etc">Making changes, fixes etc.</a></li>
|
<li><a href="#making-changes-fixes-etc">Making changes, fixes etc.</a></li>
|
||||||
<li><a href="#committing-your-changes">Committing your changes</a></li>
|
<li><a href="#committing-your-changes">Committing your changes</a></li>
|
||||||
<li><a href="#opening-a-pull-request">Opening a pull request</a></li>
|
<li><a href="#opening-a-pull-request">Opening a pull request</a></li>
|
||||||
@@ -2760,18 +2760,18 @@ GitHub, it could be anything you wish, as long as it’s in <code>~/.ssh</code>.
|
|||||||
it might be <code>~/.ssh/github.pub</code>.</p>
|
it might be <code>~/.ssh/github.pub</code>.</p>
|
||||||
<p>Whatever the key file is, copy the contents and paste it into the GitHub field
|
<p>Whatever the key file is, copy the contents and paste it into the GitHub field
|
||||||
labelled <em>Key</em>. Once you have done so click on <em>Add SSH key</em>.</p>
|
labelled <em>Key</em>. Once you have done so click on <em>Add SSH key</em>.</p>
|
||||||
<h4 id="forking-the-temp-test-ioccc-repo">Forking the temp-test-ioccc repo</h4>
|
<h4 id="forking-the-ioccc-winner-repo">Forking the IOCCC winner repo</h4>
|
||||||
<p>Open in your browser the link:
|
<p>Open in your browser the link:
|
||||||
<a href="https://github.com/ioccc-src/temp-test-ioccc/fork" class="uri">https://github.com/ioccc-src/temp-test-ioccc/fork</a>. You now should follow the
|
<a href="https://github.com/ioccc-src/winner/fork" class="uri">https://github.com/ioccc-src/winner/fork</a>. You now should follow the
|
||||||
instructions in forking the repo.</p>
|
instructions in forking the repo.</p>
|
||||||
<h4 id="cloning-the-temp-test-ioccc-repo">Cloning the temp-test-ioccc repo</h4>
|
<h4 id="cloning-the-ioccc-winner-repo">Cloning the IOCCC winner repo</h4>
|
||||||
<p>Once you have forked the repo you are ready to clone it to your system. For
|
<p>Once you have forked the repo you are ready to clone it to your system. For
|
||||||
instance Cody Boone Ferguson has the GitHub handle <em>xexyl</em> so he would type in:</p>
|
instance Cody Boone Ferguson has the GitHub handle <em>xexyl</em> so he would type in:</p>
|
||||||
<pre><code> git clone https://github.com/xexyl/temp-test-ioccc [target_dir]</code></pre>
|
<pre><code> git clone https://github.com/xexyl/winner [target_dir]</code></pre>
|
||||||
<p>Once that is completed you will need to change to that directory. The default
|
<p>Once that is completed you will need to change to that directory. The default
|
||||||
directory would be the name of the repo but if you specified a target directory
|
directory would be the name of the repo but if you specified a target directory
|
||||||
it will be that. For instance using the above example you might do:</p>
|
it will be that. For instance using the above example you might do:</p>
|
||||||
<pre><code> cd temp-test-ioccc</code></pre>
|
<pre><code> cd winner</code></pre>
|
||||||
<p>You’re ready to make your changes now!</p>
|
<p>You’re ready to make your changes now!</p>
|
||||||
<h4 id="making-changes-fixes-etc.">Making changes, fixes etc.</h4>
|
<h4 id="making-changes-fixes-etc.">Making changes, fixes etc.</h4>
|
||||||
<p>Here you must use your wits, knowledge, creativity and whatever else you have.
|
<p>Here you must use your wits, knowledge, creativity and whatever else you have.
|
||||||
@@ -2803,8 +2803,8 @@ with your ssh key. To do this you need to do:</p>
|
|||||||
<p>Hi xexyl! You’ve successfully authenticated, but GitHub does not provide shell access.</p>
|
<p>Hi xexyl! You’ve successfully authenticated, but GitHub does not provide shell access.</p>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>Now, assuming that the forked repo is
|
<p>Now, assuming that the forked repo is
|
||||||
<a href="https://github.com/xexyl/temp-test-ioccc" class="uri">https://github.com/xexyl/temp-test-ioccc</a>, you’d type:</p>
|
<a href="https://github.com/xexyl/winner" class="uri">https://github.com/xexyl/winner</a>, you’d type:</p>
|
||||||
<pre><code> git remote set-url origin git@github.com:xexyl/temp-test-ioccc.git</code></pre>
|
<pre><code> git remote set-url origin git@github.com:xexyl/winner.git</code></pre>
|
||||||
<p>Now you’d be ready to make your commits.</p>
|
<p>Now you’d be ready to make your commits.</p>
|
||||||
<p>Before doing anything else, however, a new branch needs to be created.
|
<p>Before doing anything else, however, a new branch needs to be created.
|
||||||
Continuing the example above for
|
Continuing the example above for
|
||||||
@@ -2840,16 +2840,16 @@ warrant the log:</p>
|
|||||||
remote: Resolving deltas: 100% (4/4), completed with 4 local objects.
|
remote: Resolving deltas: 100% (4/4), completed with 4 local objects.
|
||||||
remote:
|
remote:
|
||||||
remote: Create a pull request for 'human-snakes' on GitHub by visiting:
|
remote: Create a pull request for 'human-snakes' on GitHub by visiting:
|
||||||
remote: https://github.com/xexyl/temp-test-ioccc/pull/new/human-snakes
|
remote: https://github.com/xexyl/winner/pull/new/human-snakes
|
||||||
remote:
|
remote:
|
||||||
To github.com:xexyl/temp-test-ioccc.git
|
To github.com:xexyl/winner.git
|
||||||
* [new branch] human-snakes -> human-snakes
|
* [new branch] human-snakes -> human-snakes
|
||||||
branch 'human-snakes' set up to track 'origin/human-snakes'.</code></pre>
|
branch 'human-snakes' set up to track 'origin/human-snakes'.</code></pre>
|
||||||
<p>The link referred to above would then be opened to open a pull request. Just
|
<p>The link referred to above would then be opened to open a pull request. Just
|
||||||
follow the instructions at this point. If however it does not show a link it is
|
follow the instructions at this point. If however it does not show a link it is
|
||||||
likely because the branch already exists in your GitHub account (for the repo).
|
likely because the branch already exists in your GitHub account (for the repo).
|
||||||
In this case you can open the link:
|
In this case you can open the link:
|
||||||
<a href="https://github.com/ioccc-src/temp-test-ioccc/pulls" class="uri">https://github.com/ioccc-src/temp-test-ioccc/pulls</a> which might show something
|
<a href="https://github.com/ioccc-src/winner/pulls" class="uri">https://github.com/ioccc-src/winner/pulls</a> which might show something
|
||||||
like:</p>
|
like:</p>
|
||||||
<pre><code> xexyl:human-snakes had recent pushes 1 minute ago</code></pre>
|
<pre><code> xexyl:human-snakes had recent pushes 1 minute ago</code></pre>
|
||||||
<p>and to the right of it you would see a button that says <em>Compare & pull request</em>
|
<p>and to the right of it you would see a button that says <em>Compare & pull request</em>
|
||||||
@@ -2875,7 +2875,7 @@ in the matter.</p>
|
|||||||
<p>When the judges have merged the pull request you now need to make sure your fork
|
<p>When the judges have merged the pull request you now need to make sure your fork
|
||||||
has the merge. To do this from the command line, assuming the fork in the above
|
has the merge. To do this from the command line, assuming the fork in the above
|
||||||
example, you would type:</p>
|
example, you would type:</p>
|
||||||
<pre><code> git checkout master && git pull https://github.com/ioccc-src/temp-test-ioccc.git master && git push origin master</code></pre>
|
<pre><code> git checkout master && git pull https://github.com/ioccc-src/winner.git master && git push origin master</code></pre>
|
||||||
<p>This will merge your pull request to your fork.</p>
|
<p>This will merge your pull request to your fork.</p>
|
||||||
<div id="faq6_11">
|
<div id="faq6_11">
|
||||||
<div id="license">
|
<div id="license">
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# FAQ Table of Contents <!-- XXX - Change the references from _temp-test-ioccc_ to _winners_ when these fixes are merged. -->
|
# FAQ Table of Contents
|
||||||
|
|
||||||
|
|
||||||
## Section 0 - [Submitting entries to a new IOCCC](#faq0)
|
## Section 0 - [Submitting entries to a new IOCCC](#faq0)
|
||||||
@@ -435,11 +435,11 @@ and on the [IOCCC mkiocccentry tools](https://github.com/ioccc-src/mkiocccentry)
|
|||||||
|
|
||||||
To comment on the [IOCCC rules](next/rules.html) or the
|
To comment on the [IOCCC rules](next/rules.html) or the
|
||||||
[IOCCC guidelines](next/guidelines.html) please view the
|
[IOCCC guidelines](next/guidelines.html) please view the
|
||||||
[GitHub discussions for this repo](https://github.com/ioccc-src/temp-test-ioccc/discussions).
|
[GitHub discussions for this repo](https://github.com/ioccc-src/winner/discussions).
|
||||||
If there is an on-going discussion that seems relevant to what you
|
If there is an on-going discussion that seems relevant to what you
|
||||||
have to say, consider adding comments to that particular discussion.
|
have to say, consider adding comments to that particular discussion.
|
||||||
Otherwise consider opening a [new IOCCC repo
|
Otherwise consider opening a [new IOCCC repo
|
||||||
discussion](https://github.com/ioccc-src/temp-test-ioccc/discussions/new/choose).
|
discussion](https://github.com/ioccc-src/winner/discussions/new/choose).
|
||||||
|
|
||||||
To comment on [IOCCC mkiocccentry tools](https://github.com/ioccc-src/mkiocccentry),
|
To comment on [IOCCC mkiocccentry tools](https://github.com/ioccc-src/mkiocccentry),
|
||||||
please view the [mkiocccentry repo discussions](https://github.com/ioccc-src/mkiocccentry/discussions).
|
please view the [mkiocccentry repo discussions](https://github.com/ioccc-src/mkiocccentry/discussions).
|
||||||
@@ -742,7 +742,7 @@ files) that is more consistent across IOCCC years.
|
|||||||
tools and scripts](bin/index.html).
|
tools and scripts](bin/index.html).
|
||||||
* Setting up a system whereby authors of IOCCC entries may update their own
|
* Setting up a system whereby authors of IOCCC entries may update their own
|
||||||
contact information via a [GitHub pull
|
contact information via a [GitHub pull
|
||||||
request](https://github.com/ioccc-src/temp-test-ioccc/pulls).
|
request](https://github.com/ioccc-src/winner/pulls).
|
||||||
* Setting up to generate the top level [years.html](years.html) file via the
|
* Setting up to generate the top level [years.html](years.html) file via the
|
||||||
[gen-years.sh](%%REPO_URL%%/bin/gen-years.sh) tool.
|
[gen-years.sh](%%REPO_URL%%/bin/gen-years.sh) tool.
|
||||||
* Setting up to generate the top level [authors.html file](authors.html), renamed
|
* Setting up to generate the top level [authors.html file](authors.html), renamed
|
||||||
@@ -1803,7 +1803,7 @@ that you may wish to try.
|
|||||||
It also possible that you may have discovered a bug in an winning IOCCC
|
It also possible that you may have discovered a bug in an winning IOCCC
|
||||||
entry. If so, you are invited to try an fix the IOCCC entry and
|
entry. If so, you are invited to try an fix the IOCCC entry and
|
||||||
submit that fix by way of a [GitHub pull
|
submit that fix by way of a [GitHub pull
|
||||||
request](https://github.com/ioccc-src/temp-test-ioccc/pulls).
|
request](https://github.com/ioccc-src/winner/pulls).
|
||||||
Please see [FAQ 5.2](#fix_an_entry) for how to submit a fix to an IOCCC entry.
|
Please see [FAQ 5.2](#fix_an_entry) for how to submit a fix to an IOCCC entry.
|
||||||
|
|
||||||
|
|
||||||
@@ -2444,7 +2444,7 @@ section may offer you important fixing clues.
|
|||||||
|
|
||||||
We do not 'maintain' the contest entries as such. The code is made available on an 'AS
|
We do not 'maintain' the contest entries as such. The code is made available on an 'AS
|
||||||
IS' basis. If you have a FIX for an entry, we suggest that you submit your fixes in a [GitHub pull
|
IS' basis. If you have a FIX for an entry, we suggest that you submit your fixes in a [GitHub pull
|
||||||
request](https://github.com/ioccc-src/temp-test-ioccc/pulls) as we welcome pull requests that have a
|
request](https://github.com/ioccc-src/winner/pulls) as we welcome pull requests that have a
|
||||||
minimal impact on the entry while improving the portability, functionality, and/or addressing known problems.
|
minimal impact on the entry while improving the portability, functionality, and/or addressing known problems.
|
||||||
|
|
||||||
If you do submit a pull request, we ask that each pull request address just one IOCCC entry at a time.
|
If you do submit a pull request, we ask that each pull request address just one IOCCC entry at a time.
|
||||||
@@ -3505,8 +3505,8 @@ To help you out here is a navigation menu in this FAQ entry:
|
|||||||
|
|
||||||
- [Creating a GitHub account](#creating-a-github-account)
|
- [Creating a GitHub account](#creating-a-github-account)
|
||||||
- [Installing an ssh key to GitHub](#installing-an-ssh-key)
|
- [Installing an ssh key to GitHub](#installing-an-ssh-key)
|
||||||
- [Forking the temp-test-ioccc repo](#forking-the-temp-test-ioccc-repo)
|
- [Forking the IOCCC winner repo](#forking-the-ioccc-winner-repo)
|
||||||
- [Cloning the temp-test-ioccc repo](#cloning-the-temp-test-ioccc-repo)
|
- [Cloning the IOCCC winner repo](#cloning-the-ioccc-winner-repo)
|
||||||
- [Making changes, fixes etc.](#making-changes-fixes-etc)
|
- [Making changes, fixes etc.](#making-changes-fixes-etc)
|
||||||
- [Committing your changes](#committing-your-changes)
|
- [Committing your changes](#committing-your-changes)
|
||||||
- [Opening a pull request](#opening-a-pull-request)
|
- [Opening a pull request](#opening-a-pull-request)
|
||||||
@@ -3549,20 +3549,20 @@ it might be `~/.ssh/github.pub`.
|
|||||||
Whatever the key file is, copy the contents and paste it into the GitHub field
|
Whatever the key file is, copy the contents and paste it into the GitHub field
|
||||||
labelled _Key_. Once you have done so click on _Add SSH key_.
|
labelled _Key_. Once you have done so click on _Add SSH key_.
|
||||||
|
|
||||||
#### Forking the temp-test-ioccc repo
|
#### Forking the IOCCC winner repo
|
||||||
|
|
||||||
Open in your browser the link:
|
Open in your browser the link:
|
||||||
<https://github.com/ioccc-src/temp-test-ioccc/fork>. You now should follow the
|
<https://github.com/ioccc-src/winner/fork>. You now should follow the
|
||||||
instructions in forking the repo.
|
instructions in forking the repo.
|
||||||
|
|
||||||
|
|
||||||
#### Cloning the temp-test-ioccc repo
|
#### Cloning the IOCCC winner repo
|
||||||
|
|
||||||
Once you have forked the repo you are ready to clone it to your system. For
|
Once you have forked the repo you are ready to clone it to your system. For
|
||||||
instance Cody Boone Ferguson has the GitHub handle _xexyl_ so he would type in:
|
instance Cody Boone Ferguson has the GitHub handle _xexyl_ so he would type in:
|
||||||
|
|
||||||
``` <!---sh-->
|
``` <!---sh-->
|
||||||
git clone https://github.com/xexyl/temp-test-ioccc [target_dir]
|
git clone https://github.com/xexyl/winner [target_dir]
|
||||||
```
|
```
|
||||||
|
|
||||||
Once that is completed you will need to change to that directory. The default
|
Once that is completed you will need to change to that directory. The default
|
||||||
@@ -3570,7 +3570,7 @@ directory would be the name of the repo but if you specified a target directory
|
|||||||
it will be that. For instance using the above example you might do:
|
it will be that. For instance using the above example you might do:
|
||||||
|
|
||||||
``` <!---sh-->
|
``` <!---sh-->
|
||||||
cd temp-test-ioccc
|
cd winner
|
||||||
```
|
```
|
||||||
|
|
||||||
You're ready to make your changes now!
|
You're ready to make your changes now!
|
||||||
@@ -3619,11 +3619,11 @@ Cody would see:
|
|||||||
> Hi xexyl! You've successfully authenticated, but GitHub does not provide shell access.
|
> Hi xexyl! You've successfully authenticated, but GitHub does not provide shell access.
|
||||||
|
|
||||||
Now, assuming that the forked repo is
|
Now, assuming that the forked repo is
|
||||||
<https://github.com/xexyl/temp-test-ioccc>, you'd type:
|
<https://github.com/xexyl/winner>, you'd type:
|
||||||
|
|
||||||
|
|
||||||
``` <!---sh-->
|
``` <!---sh-->
|
||||||
git remote set-url origin git@github.com:xexyl/temp-test-ioccc.git
|
git remote set-url origin git@github.com:xexyl/winner.git
|
||||||
```
|
```
|
||||||
|
|
||||||
Now you'd be ready to make your commits.
|
Now you'd be ready to make your commits.
|
||||||
@@ -3688,9 +3688,9 @@ This might show:
|
|||||||
remote: Resolving deltas: 100% (4/4), completed with 4 local objects.
|
remote: Resolving deltas: 100% (4/4), completed with 4 local objects.
|
||||||
remote:
|
remote:
|
||||||
remote: Create a pull request for 'human-snakes' on GitHub by visiting:
|
remote: Create a pull request for 'human-snakes' on GitHub by visiting:
|
||||||
remote: https://github.com/xexyl/temp-test-ioccc/pull/new/human-snakes
|
remote: https://github.com/xexyl/winner/pull/new/human-snakes
|
||||||
remote:
|
remote:
|
||||||
To github.com:xexyl/temp-test-ioccc.git
|
To github.com:xexyl/winner.git
|
||||||
* [new branch] human-snakes -> human-snakes
|
* [new branch] human-snakes -> human-snakes
|
||||||
branch 'human-snakes' set up to track 'origin/human-snakes'.
|
branch 'human-snakes' set up to track 'origin/human-snakes'.
|
||||||
```
|
```
|
||||||
@@ -3699,7 +3699,7 @@ The link referred to above would then be opened to open a pull request. Just
|
|||||||
follow the instructions at this point. If however it does not show a link it is
|
follow the instructions at this point. If however it does not show a link it is
|
||||||
likely because the branch already exists in your GitHub account (for the repo).
|
likely because the branch already exists in your GitHub account (for the repo).
|
||||||
In this case you can open the link:
|
In this case you can open the link:
|
||||||
<https://github.com/ioccc-src/temp-test-ioccc/pulls> which might show something
|
<https://github.com/ioccc-src/winner/pulls> which might show something
|
||||||
like:
|
like:
|
||||||
|
|
||||||
```
|
```
|
||||||
@@ -3736,7 +3736,7 @@ has the merge. To do this from the command line, assuming the fork in the above
|
|||||||
example, you would type:
|
example, you would type:
|
||||||
|
|
||||||
``` <!---sh-->
|
``` <!---sh-->
|
||||||
git checkout master && git pull https://github.com/ioccc-src/temp-test-ioccc.git master && git push origin master
|
git checkout master && git pull https://github.com/ioccc-src/winner.git master && git push origin master
|
||||||
```
|
```
|
||||||
|
|
||||||
This will merge your pull request to your fork.
|
This will merge your pull request to your fork.
|
||||||
|
|||||||
@@ -381,6 +381,7 @@
|
|||||||
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
|
||||||
|
|
||||||
<!-- BEFORE: 1st line of markdown file: index.md -->
|
<!-- BEFORE: 1st line of markdown file: index.md -->
|
||||||
|
<!-- XXX - This entire section goes away during the final stages of the Great Fork Merge -->
|
||||||
<h1 id="this-is-an-experimental-ioccc-web-site">THIS IS AN EXPERIMENTAL IOCCC WEB SITE</h1>
|
<h1 id="this-is-an-experimental-ioccc-web-site">THIS IS AN EXPERIMENTAL IOCCC WEB SITE</h1>
|
||||||
<p><strong>IMPORTANT: This is NOT the official IOCCC web site!</strong></p>
|
<p><strong>IMPORTANT: This is NOT the official IOCCC web site!</strong></p>
|
||||||
<p>Please visit <a href="https://www.ioccc.org/index.html">www.ioccc.org</a> for the official IOCCC web.</p>
|
<p>Please visit <a href="https://www.ioccc.org/index.html">www.ioccc.org</a> for the official IOCCC web.</p>
|
||||||
@@ -390,6 +391,8 @@
|
|||||||
<p>This web site will be undergoing major changes, so expect many broken links, typos and other problems.
|
<p>This web site will be undergoing major changes, so expect many broken links, typos and other problems.
|
||||||
If you wish to recommend changes (understanding that things may be rapidly changing out from under your copy),
|
If you wish to recommend changes (understanding that things may be rapidly changing out from under your copy),
|
||||||
then consider making pull requests against the <a href="https://github.com/ioccc-src/temp-test-ioccc">temp-test-ioccc GitHub repo</a>.</p>
|
then consider making pull requests against the <a href="https://github.com/ioccc-src/temp-test-ioccc">temp-test-ioccc GitHub repo</a>.</p>
|
||||||
|
<h2 id="what-follows-is-the-actual-index.html-file">What follows is the actual index.html file</h2>
|
||||||
|
<!-- XXX - remove down to here in the final stages of the Great Fork Merge -->
|
||||||
<h1 id="suggestions-for-visitors">Suggestions for visitors</h1>
|
<h1 id="suggestions-for-visitors">Suggestions for visitors</h1>
|
||||||
<p>Explore, under the <strong>Entries</strong> in the <em>topbar</em> menu:</p>
|
<p>Explore, under the <strong>Entries</strong> in the <em>topbar</em> menu:</p>
|
||||||
<ul>
|
<ul>
|
||||||
|
|||||||
@@ -1,3 +1,4 @@
|
|||||||
|
<!-- XXX - This entire section goes away during the final stages of the Great Fork Merge -->
|
||||||
# THIS IS AN EXPERIMENTAL IOCCC WEB SITE
|
# THIS IS AN EXPERIMENTAL IOCCC WEB SITE
|
||||||
|
|
||||||
**IMPORTANT: This is NOT the official IOCCC web site!**
|
**IMPORTANT: This is NOT the official IOCCC web site!**
|
||||||
@@ -14,7 +15,9 @@ This web site will be undergoing major changes, so expect many broken links, typ
|
|||||||
If you wish to recommend changes (understanding that things may be rapidly changing out from under your copy),
|
If you wish to recommend changes (understanding that things may be rapidly changing out from under your copy),
|
||||||
then consider making pull requests against the [temp-test-ioccc GitHub repo](https://github.com/ioccc-src/temp-test-ioccc).
|
then consider making pull requests against the [temp-test-ioccc GitHub repo](https://github.com/ioccc-src/temp-test-ioccc).
|
||||||
|
|
||||||
|
## What follows is the actual index.html file
|
||||||
|
|
||||||
|
<!-- XXX - remove down to here in the final stages of the Great Fork Merge -->
|
||||||
# Suggestions for visitors
|
# Suggestions for visitors
|
||||||
|
|
||||||
Explore, under the **Entries** in the _topbar_ menu:
|
Explore, under the **Entries** in the _topbar_ menu:
|
||||||
|
|||||||
@@ -291,7 +291,7 @@ X11_INCDIR= /opt/X11/include
|
|||||||
# For details on how to install SDL/SDL2 see FAQ 3.8 - How do I compile an
|
# For details on how to install SDL/SDL2 see FAQ 3.8 - How do I compile an
|
||||||
# IOCCC entry that requires SDL1 or SDL2? which can be found at:
|
# IOCCC entry that requires SDL1 or SDL2? which can be found at:
|
||||||
#
|
#
|
||||||
# https://ioccc-src.github.io/temp-test-ioccc/faq.html#SDL
|
# https://www.ioccc.org/faq.html#SDL
|
||||||
#
|
#
|
||||||
# SDL2_INCLUDE_ROOT is the directory under which include/SDL/ and/or
|
# SDL2_INCLUDE_ROOT is the directory under which include/SDL/ and/or
|
||||||
# include/SDL2/ may be found.
|
# include/SDL2/ may be found.
|
||||||
|
|||||||
Reference in new issue
Block a user