From f5f72ac9a80c9834b09cb2bf106fabed542c7e4c Mon Sep 17 00:00:00 2001
From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com>
Date: Wed, 1 May 2024 08:44:47 -0700
Subject: [PATCH] Change 2018/ferguson/FILES to markdown
Built html file, removed FILES itself. Manifest update coming up.
---
2018/ferguson/FILES | 79 ------
2018/ferguson/FILES.html | 488 ++++++++++++++++++++++++++++++++++++++
2018/ferguson/FILES.md | 61 +++++
2018/ferguson/weasel.spec | 2 +-
4 files changed, 550 insertions(+), 80 deletions(-)
delete mode 100644 2018/ferguson/FILES
create mode 100644 2018/ferguson/FILES.html
create mode 100644 2018/ferguson/FILES.md
diff --git a/2018/ferguson/FILES b/2018/ferguson/FILES
deleted file mode 100644
index 99da7dcf1..000000000
--- a/2018/ferguson/FILES
+++ /dev/null
@@ -1,79 +0,0 @@
-This file is a brief description of the files in this entry.
-
-
-prog.c This is the source file to the `weasel'
- program [1].
-
-
-prog.alt.c This is the source code file to the
- `weasel.alt' program [1].
-
-
-test.sh Script provided to test the weasel program [1].
-
-
-test-strings.txt The test.sh script reads from this file and runs
- the weasel program for each line read.
-
-
-Makefile The Makefile that simplifies compilation as well as
- providing some deep magic and other things designed
- by the IOCCC judges. There's also a `make test'
- target that runs the 'test.sh' script. The hint
- file shows how to pass options to the script
- itself [1].
-
-
-weasel.1 The man page for weasel.
-
-
-README.md The source of the index.html file [3].
-
-
-hint.html More thorough documentation including example
- invocations, how to compile, final and winning
- thoughts, some of the obfuscation techniques that
- might be used, etc. [3].
-
-
-hint.css The CSS file for the hint.html file [3].
-
-
-rpm.md This file briefly answers 'why' I submitted a rpm
- spec file 'weasel.spec' as well as the possibility
- of building the RPM for others (despite the fact I
- am confident that I'm the only one who would make
- use of it). This file isn't included in the RPM
- itself; it remains only on the IOCCC website.
-
-
-weasel.spec The RPM spec file for building the RPM. This is
- specific to the entry on the IOCCC website but
- would also be available in the source rpm file if
- it was built.
-
-
-FILES If you want a brief description of the FILES file
- (this file) then read this file (the file FILES).
-
-
-
-* Footnotes
-
-The follow footnotes are for if the weasel program is installed into the
-system. As I noted before it was primarily personal reasons that I submitted
-the spec file. Please note that the paths below are dependent on the prefix
-used in installation; where I suggest '/usr' it is equally possible it could be
-under '/usr/local', for example.
-
-[1] Note that 'prog.c' and 'prog.alt.c' would be
- linked to 'weasel.c' and 'weasel.alt.c'
- (respectively) in the '/usr/src/weasel'
- subdirectory.
-
-[2] The file would most likely be compressed as
- 'weasel.1.gz' under the '/usr/share/man/man1'
- subdirectory.
-
-[3] These files would be in the
- '/usr/share/doc/weasel' subdirectory.
diff --git a/2018/ferguson/FILES.html b/2018/ferguson/FILES.html
new file mode 100644
index 000000000..40e0d594b
--- /dev/null
+++ b/2018/ferguson/FILES.html
@@ -0,0 +1,488 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
List of files in this entry with a brief description
+
+prog.c This is the source file to the `weasel’
+program [1].
+prog.alt.c This is the source code file to the
+weasel.alt program [1].
+test.sh Script provided to test the weasel program [1].
+test-strings.txt The test.sh script reads from this file and runs
+Makefile The Makefile that simplifies compilation as well as
+providing some deep magic and other things designed
+by the IOCCC judges. There’s also a make test
+target that runs the test.sh script. The
+index.html file shows how to pass options to the
+script itself [1].
+weasel.1 The man page for weasel.
+README.md The source of the index.html file [3].
+rpm.md This file briefly answers ‘why’ I submitted an rpm
+spec file ‘weasel.spec’ as well as the possibility
+of building the RPM for others (despite the fact I
+am confident that I’m the only one who would make
+use of it). This file isn’t included in the RPM
+itself; it remains only on the IOCCC website.
+weasel.spec The RPM spec file for building the RPM. This is
+specific to the entry on the IOCCC website but
+would also be available in the source rpm file if
+it was built.
+FILES.md If you want a brief description of the FILES.md file
+(this file) then read this file (the file FILES.md).
+
+
+
The follow footnotes are for if the weasel program is installed into the
+system via the RPM file (that can be built by say rpmbuild -bb weasel.spec on
+an RPM linux system).
+
As I noted before it was primarily personal reasons that I submitted the spec
+file. Years later I thought of removing it but since I quite enjoyed the judges’
+remarks I have kept it in place. Please note that the paths below are dependent
+on the prefix used in installation; where I suggest /usr it is equally
+possible it could be under ‘/usr/local’, for example.
+
[1] Note that prog.c and
+prog.alt.c would be
+linked to weasel.c and weasel.alt.c
+(respectively) in the /usr/src/weasel
+subdirectory.
+
[2] The file would most likely be compressed as
+weasel.1.gz under the /usr/share/man/man1
+subdirectory.
+
[3] These files would be in the /usr/share/doc/weasel
+subdirectory.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/2018/ferguson/FILES.md b/2018/ferguson/FILES.md
new file mode 100644
index 000000000..0874b35d4
--- /dev/null
+++ b/2018/ferguson/FILES.md
@@ -0,0 +1,61 @@
+# List of files in this entry with a brief description
+
+- [prog.c](prog.c)
+ * This is the source file to the `weasel` program [1].
+- [prog.alt.c](prog.alt.c)
+ * This is the source code file to the `weasel.alt` program [1].
+- [test.sh](test.sh)
+ * Script provided to test the weasel program [1].
+- [test-strings.txt](test-strings.txt)
+ * The `test.sh` script reads from this file and runs the program with these
+ target strings.
+
+- [Makefile](Makefile)
+ * The Makefile that simplifies compilation as well as providing some deep
+ magic and other things designed by the IOCCC judges. There's also a `make
+ test` target that runs the `test.sh` script. The index.html file shows how
+ to pass options to the script itself [1].
+- [weasel.1](weasel.1)
+ * The man page for weasel.
+- [README.md](README.md)
+ * The source of the index.html file [3].
+- [rpm.md](rpm.md)
+ * This file briefly answers 'why' I submitted an rpm spec file 'weasel.spec'
+ as well as the possibility of building the RPM for others (despite the fact
+ I am confident that I'm the only one who would make use of it). This file
+ isn't included in the RPM itself; it remains only on the IOCCC website.
+- [weasel.spec](weasel.spec)
+ * The RPM spec file for building the RPM. This is specific to the entry on
+ the IOCCC website but would also be available in the source rpm file if it
+ was built.
+- [FILES.html](FILES.html)
+ * This web page.
+- [FILES.md](FILES.md)
+ * The markdown source file for [FILES.html](FILES.html)
+
+
+
+## Footnote
+
+The follow footnotes are for if the weasel program is installed into the
+system via the RPM file (that can be built by say `rpmbuild -bb weasel.spec` on
+an RPM linux system).
+
+As I noted before it was primarily personal reasons that I submitted the spec
+file. Years later I thought of removing it but since I quite enjoyed the judges'
+remarks I have kept it in place. Please note that the paths below are dependent
+on the prefix used in installation; where I suggest `/usr` it is equally
+possible it could be under '/usr/local', for example.
+
+[1] Note that [prog.c](prog.c) and
+ [prog.alt.c](prog.alt.c) would be
+ linked to `weasel.c` and `weasel.alt.c`
+ (respectively) in the `/usr/src/weasel`
+ subdirectory.
+
+[2] The file would most likely be compressed as
+ `weasel.1.gz` under the `/usr/share/man/man1`
+ subdirectory.
+
+[3] These files would be in the `/usr/share/doc/weasel`
+ subdirectory.
diff --git a/2018/ferguson/weasel.spec b/2018/ferguson/weasel.spec
index 4c46d2723..47cf95b39 100644
--- a/2018/ferguson/weasel.spec
+++ b/2018/ferguson/weasel.spec
@@ -53,7 +53,7 @@ install -m 644 prog.alt.c -D $RPM_BUILD_ROOT%{_usrsrc}/weasel/weasel.alt.c
ln -s weasel.alt.c $RPM_BUILD_ROOT%{_usrsrc}/weasel/prog.alt.c
install -m 644 weasel.1 -D $RPM_BUILD_ROOT%{_mandir}/man1/weasel.1
install -m 644 README.md -D $RPM_BUILD_ROOT%{_docdir}/weasel/weasel.md
-install -m 644 FILES -D $RPM_BUILD_ROOT%{_docdir}/weasel/FILES
+install -m 644 FILES.html -D $RPM_BUILD_ROOT%{_docdir}/weasel/FILES.html
%files
%{_bindir}/weasel*