diff --git a/2018/ferguson/.entry.json b/2018/ferguson/.entry.json index 30be9698d..796286eaa 100644 --- a/2018/ferguson/.entry.json +++ b/2018/ferguson/.entry.json @@ -42,12 +42,20 @@ "entry_text" : "original source" }, { - "file_path" : "FILES", + "file_path" : "FILES.html", + "inventory_order" : 100, + "OK_to_edit" : false, + "display_as" : "html", + "display_via_github" : false, + "entry_text" : "list of files in this entry" + }, + { + "file_path" : "FILES.md", "inventory_order" : 100, "OK_to_edit" : true, "display_as" : "text", "display_via_github" : true, - "entry_text" : "information about various files" + "entry_text" : "markdown source for FILES.html" }, { "file_path" : "id.alt.sh", 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..134b3b55e --- /dev/null +++ b/2018/ferguson/FILES.html @@ -0,0 +1,529 @@ + + + + + + + + + + + + +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.

+
+

Jump to: top

+ + + + + + +
+ + + + + + + + + + + + + + + diff --git a/2018/ferguson/FILES.md b/2018/ferguson/FILES.md new file mode 100644 index 000000000..e530f2ccf --- /dev/null +++ b/2018/ferguson/FILES.md @@ -0,0 +1,80 @@ +# 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. + +
+ +Jump to: [top](#) + + + diff --git a/2018/ferguson/index.html b/2018/ferguson/index.html index 3b1d28ec3..ed3010829 100644 --- a/2018/ferguson/index.html +++ b/2018/ferguson/index.html @@ -1394,7 +1394,8 @@ email but I’m more likely to respond to mastodon messages.

  • Makefile - entry Makefile
  • prog.alt.c - alternative source
  • prog.orig.c - original source
  • -
  • FILES - information about various files
  • +
  • FILES.html - list of files in this entry
  • +
  • FILES.md - markdown source for FILES.html
  • id.alt.sh - how to run
  • id.sh - how to run
  • monkey-words.alt.sh - how to run
  • 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* diff --git a/tmp/manifest.csv b/tmp/manifest.csv index 0e77e6230..caa9d5ea0 100644 --- a/tmp/manifest.csv +++ b/tmp/manifest.csv @@ -3746,7 +3746,8 @@ 2018,ferguson,Makefile,30,true,makefile,true,entry Makefile 2018,ferguson,prog.alt.c,40,true,c,true,alternative source 2018,ferguson,prog.orig.c,50,false,c,true,original source -2018,ferguson,FILES,100,true,text,true,information about various files +2018,ferguson,FILES.html,100,false,html,false,list of files in this entry +2018,ferguson,FILES.md,100,true,text,true,markdown source for FILES.html 2018,ferguson,id.alt.sh,100,true,shellscript,true,how to run 2018,ferguson,id.sh,100,true,shellscript,true,how to run 2018,ferguson,monkey-words.alt.sh,100,true,shellscript,true,how to run diff --git a/tmp/manifest.numbers b/tmp/manifest.numbers index 370f51385..b149099c5 100644 Binary files a/tmp/manifest.numbers and b/tmp/manifest.numbers differ diff --git a/tmp/path_list.built.txt b/tmp/path_list.built.txt index fb71551f8..707c2e50f 100644 --- a/tmp/path_list.built.txt +++ b/tmp/path_list.built.txt @@ -876,6 +876,7 @@ 2018/endoh2/index.html 2018/ferguson/.path 2018/ferguson/2018_ferguson.tar.bz2 +2018/ferguson/FILES.html 2018/ferguson/index.html 2018/ferguson/rpm.html 2018/giles/.path diff --git a/tmp/path_list.found.txt b/tmp/path_list.found.txt index b06a6cfad..3418755bf 100644 --- a/tmp/path_list.found.txt +++ b/tmp/path_list.found.txt @@ -3745,7 +3745,8 @@ 2018/ferguson/.gitignore 2018/ferguson/.path 2018/ferguson/2018_ferguson.tar.bz2 -2018/ferguson/FILES +2018/ferguson/FILES.html +2018/ferguson/FILES.md 2018/ferguson/Makefile 2018/ferguson/README.md 2018/ferguson/hint.css diff --git a/tmp/path_list.manifest.txt b/tmp/path_list.manifest.txt index b06a6cfad..3418755bf 100644 --- a/tmp/path_list.manifest.txt +++ b/tmp/path_list.manifest.txt @@ -3745,7 +3745,8 @@ 2018/ferguson/.gitignore 2018/ferguson/.path 2018/ferguson/2018_ferguson.tar.bz2 -2018/ferguson/FILES +2018/ferguson/FILES.html +2018/ferguson/FILES.md 2018/ferguson/Makefile 2018/ferguson/README.md 2018/ferguson/hint.css diff --git a/tmp/path_list.required.txt b/tmp/path_list.required.txt index cd5664874..2f2f400b3 100644 --- a/tmp/path_list.required.txt +++ b/tmp/path_list.required.txt @@ -2867,7 +2867,7 @@ 2018/endoh2/try.sh 2018/ferguson/.entry.json 2018/ferguson/.gitignore -2018/ferguson/FILES +2018/ferguson/FILES.md 2018/ferguson/Makefile 2018/ferguson/README.md 2018/ferguson/hint.css