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 @@ + + + + + + + + + + + + +The International Obfuscated C Code Contest + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + + +
+ +
+ + + + + + +
+ + IOCCC image by Matt Zucker + +

The International Obfuscated C Code Contest

+

FILES.md for 2018/ferguson

+
+ + + + + + + + + +
+ + + + + +

List of files in this entry with a brief description

+ +

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 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*