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:
Landon Curt Noll committed 2024-05-30 11:17:04 -07:00
1 parent 7b0bd24f8e
commit a78d78ccff
20 files changed
+79 -74

No files matched your search

+4 -4
View File
@@ -77,7 +77,7 @@ you grow to the full size!
Size to grow every time you eat a bug.
Default 5; can be negative.
"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.
.TQ
.B SHED
@@ -109,7 +109,7 @@ or
See
.I play.sh
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.
.sp
.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?
It's a misnomer: it took fewer bytes and the negative shedding is a positive consequence of unsigned arithmetic.
.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
.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):
@@ -279,7 +279,7 @@ That will compile the game to be the colours you select and then enable cannibal
.PP
For many more gameplay information, modes and features check:
.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.
.SH AUTHOR
Written by Cody Boone Ferguson for IOCCC 2020 (the 27th IOCCC).
+3 -3
View File
@@ -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 "SoX. You will have to play the WAV output manually, sorry." 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
fi
fi
@@ -40,7 +40,7 @@ if [[ -n "$PLAY" ]]; then
else
echo "Please play pi.wav in an audio player that can play WAV files." 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
fi
@@ -60,7 +60,7 @@ else
echo 1>&2
echo "Please play jenny.wav with an audio player that can play WAV files."
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
read -r -n 1 -p "Press any key to convert 10666-28 ('IOCCC-28'): "
echo 1>&2
+2 -2
View File
@@ -42,7 +42,7 @@ convert_error()
{
echo 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 "Tip: if you have it in a different path, try: CONVERT=path ./try.sh" 1>&2
echo 1>&2
@@ -51,7 +51,7 @@ convert_error()
if [[ -z "$CONVERT" || ! -f "$CONVERT" || ! -x "$CONVERT" ]]; then
echo 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
else
"$CONVERT" -delay 10 -dither none -loop 0 "${list[@]}" +map "$output"
+2 -2
View File
@@ -21,7 +21,7 @@ convert_error()
{
echo 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 "Tip: if you have it in a different path, try: CONVERT=path ./try.sh" 1>&2
echo 1>&2
@@ -78,6 +78,6 @@ if [[ -n "$CONVERT" ]]; then
else
echo 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
fi