Change 2018/ferguson/FILES to markdown

Built html file, removed FILES itself. Manifest update coming up.
This commit is contained in:
Cody Boone Ferguson committed 2024-05-01 08:44:47 -07:00
1 parent 6e38199684
commit f5f72ac9a8
4 files changed
+550 -80

No files matched your search

-79
View File
@@ -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.
+488
View File
@@ -0,0 +1,488 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- START: two lines up starts content from: inc/top.default.html -->
<!-- END: this line ends content from: inc/top.default.html -->
<!-- START: this line starts content from: inc/head.default.html -->
<head>
<link rel="stylesheet" href="../../ioccc.css">
<link href="https://fonts.googleapis.com/css2?family=Outfit:wght@100..900&display=swap" rel="stylesheet">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>The International Obfuscated C Code Contest</title>
<link rel="icon" type="image/x-icon" href="../../favicon.ico">
<meta name="description" content="FILES.md for 2018/ferguson">
<meta name="keywords" content="IOCCC, 2018/ferguson, FILES.md">
</head>
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<!-- END: this line ends content from: inc/head.default.html -->
<!-- -->
<!-- This web page was formed via the tool: bin/gen-other-html.sh -->
<!-- The content of main section of this web page came from: 2018/ferguson/FILES.md -->
<!-- -->
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<!-- !!! Do not modify this web page, instead modify the file: 2018/ferguson/FILES.md !!! -->
<!-- !!! Do not modify this web page, instead modify the file: 2018/ferguson/FILES.md !!! -->
<!-- !!! Do not modify this web page, instead modify the file: 2018/ferguson/FILES.md !!! -->
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<!-- Markdown content was converted into HTML via the tool: bin/md2html.sh -->
<!-- START: this line starts content from: inc/body.default.html -->
<body>
<!-- END: this line ends content from: inc/body.default.html -->
<!-- START: this line starts content from: inc/topbar.default.html -->
<div class="theader">
<nav class="topbar">
<div class="container">
<div class="logo">
<a href="../../index.html" class="logo-link">
IOCCC
</a>
</div>
<div class="topbar-items">
<div class="item">
<span class="item-header">
Entries
</span>
<div class="sub-item">
<div class="outfit-font">
<a href="../../years.html" class="sub-item-link">
Winning Entries
</a>
</div>
<div class="outfit-font">
<a href="../../authors.html" class="sub-item-link">
People who have won
</a>
</div>
<div class="outfit-font">
<a href="../../location.html" class="sub-item-link">
Location of authors
</a>
</div>
<div class="outfit-font">
<a href="../../bugs.html" class="sub-item-link">
Bugs &amp; (Mis)features
</a>
</div>
</div>
</div>
<div class="item">
<span class="item-header">
Status
</span>
<div class="sub-item">
<div class="outfit-font">
<a href="../../news.html" class="sub-item-link">
IOCCC News
</a>
</div>
<div class="outfit-font">
<a href="../../status.html" class="sub-item-link">
Contest status
</a>
</div>
<div class="outfit-font">
<a href="../../next/index.html" class="sub-item-link">
Rules &amp; Guidelines
</a>
</div>
</div>
</div>
<div class="item">
<span class="item-header">
FAQ
</span>
<div class="sub-item">
<div class="outfit-font">
<a href="../../faq.html" class="sub-item-link">
FAQ
</a>
</div>
<div class="outfit-font">
<a href="../../faq.html#submit" class="sub-item-link">
How to enter the IOCCC
</a>
</div>
<div class="outfit-font">
<a href="../../faq.html#fix_an_entry" class="sub-item-link">
Fixing IOCCC entries
</a>
</div>
<div class="outfit-font">
<a href="../../faq.html#fix_web_site" class="sub-item-link">
Fixing the web site
</a>
</div>
<div class="outfit-font">
<a href="../../faq.html#fix_author" class="sub-item-link">
Fixing author info
</a>
</div>
</div>
</div>
<div class="item">
<span class="item-header">
About
</span>
<div class="sub-item">
<div class="outfit-font">
<a href="../../index.html" class="sub-item-link">
IOCCC Home
</a>
</div>
<div class="outfit-font">
<a href="../../judges.html" class="sub-item-link">
The IOCCC Judges
</a>
</div>
<div class="outfit-font">
<a href="../../contact.html" class="sub-item-link">
Contacting the IOCCC
</a>
</div>
<div class="outfit-font">
<a href="../../thanks-for-help.html" class="sub-item-link">
Thanks for the help
</a>
</div>
</div>
</div>
</div>
</div>
</nav>
<div class="header-mobile-menu">
<noscript>
<a href="../../nojs-menu.html" class="topbar-js-label">
Please Enable JavaScript
</a>
</noscript>
<button id="header-open-menu-button" class="topbar-mobile-menu">
<img
src="../../png/hamburger-icon-open.png"
alt="hamburger style menu icon - open state"
width=48
height=48>
</button>
<button id="header-close-menu-button" class="hide-content">
<img
src="../../png/hamburger-icon-closed.png"
alt="hamburger style menu icon - closed state"
width=48
height=48>
</button>
<div id="mobile-menu-panel" class="hide-content">
<div class="mobile-menu-container">
<div class="mobile-menu-wrapper">
<div class="mobile-menu-item">
Entries
</div>
<div class="mobile-submenu-wrapper">
<a class="mobile-submenu-item" href="../../years.html">
Winning Entries
</a>
<a class="mobile-submenu-item" href="../../authors.html">
People who have won
</a>
<a class="mobile-submenu-item" href="../../location.html">
Location of authors
</a>
<a class="mobile-submenu-item" href="../../bugs.html">
Bugs &amp; (Mis)features
</a>
</div>
</div>
<div class="mobile-menu-wrapper">
<div class="mobile-menu-item">
Status
</div>
<div class="mobile-submenu-wrapper">
<a class="mobile-submenu-item" href="../../status.html">
Contest status
</a>
<a class="mobile-submenu-item" href="../../next/index.html">
Rules &amp; Guidelines
</a>
<a class="mobile-submenu-item" href="../../news.html">
IOCCC News
</a>
</div>
</div>
<div class="mobile-menu-wrapper">
<div class="mobile-menu-item">
FAQ
</div>
<div class="mobile-submenu-wrapper">
<a class="mobile-submenu-item" href="../../faq.html">
Frequently Asked Questions
</a>
<a class="mobile-submenu-item" href="../../faq.html#submit">
How to enter the IOCCC
</a>
<a class="mobile-submenu-item" href="../../faq.html#fix_an_entry">
Fixing IOCCC entries
</a>
<a class="mobile-submenu-item" href="../../faq.html#fix_web_site">
Fixing the web site
</a>
<a class="mobile-submenu-item" href="../../faq.html#fix_author">
Fixing author info
</a>
</div>
</div>
<div class="mobile-menu-wrapper">
<div class="mobile-menu-item">
About
</div>
<div class="mobile-submenu-wrapper">
<a class="mobile-submenu-item" href="../../index.html">
IOCCC Home
</a>
<a class="mobile-submenu-item" href="../../judges.html">
The IOCCC Judges
</a>
<a class="mobile-submenu-item" href="../../contact.html">
Contacting the IOCCC
</a>
<a class="mobile-submenu-item" href="../../thanks-for-help.html">
Thanks for the help
</a>
</div>
</div>
</div>
</div>
</div>
</div>
<script>
var headerOpenMenuButton = document.getElementById("header-open-menu-button");
var headerCloseMenuButton = document.getElementById("header-close-menu-button");
var mobileMenuPanel = document.getElementById("mobile-menu-panel");
headerOpenMenuButton.addEventListener("click", () => {
headerOpenMenuButton.classList.remove("topbar-mobile-menu");
headerOpenMenuButton.classList.add("hide-content");
headerCloseMenuButton.classList.remove("hide-content");
headerCloseMenuButton.classList.add("topbar-mobile-menu");
mobileMenuPanel.classList.remove("hide-content");
mobileMenuPanel.classList.add("topbar-mobile-panel");
});
headerCloseMenuButton.addEventListener("click", () => {
headerCloseMenuButton.classList.remove("topbar-mobile-menu");
headerCloseMenuButton.classList.add("hide-content");
mobileMenuPanel.classList.add("hide-content");
mobileMenuPanel.classList.remove("topbar-mobile-panel");
headerOpenMenuButton.classList.add("topbar-mobile-menu");
headerOpenMenuButton.classList.remove("hide-content");
});
</script>
<!-- END: this line ends content from: inc/topbar.default.html -->
<!-- START: this line starts content from: inc/header.default.html -->
<div class="header">
<a href="../../2011/zucker/index.html">
<img src="../../png/ioccc.png"
alt="IOCCC image by Matt Zucker"
width=300
height=110>
</a>
<h1>The International Obfuscated C Code Contest</h1>
<h2>FILES.md for 2018/ferguson</h2>
</div>
<!-- END: this line ends content from: inc/header.default.html -->
<!-- START: this line starts content from: inc/navbar.up2index.html -->
<div class="navbar">
<a class="Left" href="index.html">&uarr; jump to index.html &uarr;</a>
<a class="Right" href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F2018%2Fferguson%2FFILES.html">&#x2713;</a>
</div>
<!-- END: this line ends content from: inc/navbar.up2index.html -->
<!-- START: this line starts content from: inc/before-content.default.html -->
<div class="content" id="content">
<!-- END: this line ends content from: inc/before-content.default.html -->
<!-- START: this line starts content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- BEFORE: 1st line of markdown file: 2018/ferguson/FILES.md -->
<h1 id="list-of-files-in-this-entry-with-a-brief-description">List of files in this entry with a brief description</h1>
<ul>
<li><p>prog.c This is the source file to the `weasel’
program [1].</p></li>
<li><p>prog.alt.c This is the source code file to the
<code>weasel.alt</code> program [1].</p></li>
<li><p>test.sh Script provided to test the weasel program [1].</p></li>
<li><p>test-strings.txt The <code>test.sh</code> script reads from this file and runs</p></li>
<li><p>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 <code>make test</code>
target that runs the <code>test.sh</code> script. The
index.html file shows how to pass options to the
script itself [1].</p></li>
<li><p>weasel.1 The man page for weasel.</p></li>
<li><p>README.md The source of the index.html file [3].</p></li>
<li><p>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.</p></li>
<li><p>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.</p></li>
<li><p>FILES.md If you want a brief description of the FILES.md file
(this file) then read this file (the file FILES.md).</p></li>
</ul>
<h2 id="footnote">Footnote</h2>
<p>The follow footnotes are for if the weasel program is installed into the
system via the RPM file (that can be built by say <code>rpmbuild -bb weasel.spec</code> on
an RPM linux system).</p>
<p>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 <code>/usr</code> it is equally
possible it could be under ‘/usr/local’, for example.</p>
<p>[1] Note that <a href="prog.c">prog.c</a> and
<a href="prog.alt.c">prog.alt.c</a> would be
linked to <code>weasel.c</code> and <code>weasel.alt.c</code>
(respectively) in the <code>/usr/src/weasel</code>
subdirectory.</p>
<p>[2] The file would most likely be compressed as
<code>weasel.1.gz</code> under the <code>/usr/share/man/man1</code>
subdirectory.</p>
<p>[3] These files would be in the <code>/usr/share/doc/weasel</code>
subdirectory.
<!-- AFTER: last line of markdown file: 2018/ferguson/FILES.md --></p>
<!-- END: this line ends content for HTML phase 21 by: bin/pandoc-wrapper.sh via bin/md2html.sh -->
<!-- START: this line starts content from: inc/after-content.default.html -->
</div>
<!-- END: this line ends content from: inc/after-content.default.html -->
<!-- START: this line starts content from: inc/footer.default.html -->
<!--
Copyright © 1984-2024 by Landon Curt Noll. All Rights Reserved.
You are free to share and adapt this file under the terms of this license:
Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
For more information, see:
https://creativecommons.org/licenses/by-sa/4.0/
-->
<div class="footer">
<div id="copyright"><h2>Copyright and CC BY-SA 4.0 License</h2></div>
<p>All IOCCC content including this file and web page are:</p>
<b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Copyright &copy; 1984-2024 by Landon Curt Noll. <a href="https://creativecommons.org/faq/#what-does-some-rights-reserved-mean">Some Rights Reserved</a>.</b>
<p>This work is licensed by Landon Curt Noll under:</p>
<p><b><a href="https://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1"
target="_blank" rel="license noopener noreferrer" style="display:inline-block;">&nbsp;&nbsp;&nbsp;&nbsp;CC BY-SA 4.0
<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;"
src="../../png/cc.png"
alt="cc inside circle symbol">
<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;"
src="../../png/by.png"
alt="person inside circle symbol">
<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;"
src="../../png/sa.png"
alt="arrow looping back on itself inside circle symbol">
</a></b></p>
<p>The <b>CC BY-SA 4.0 LEGAL CODE</b> for this license is found under:</p>
<p>&nbsp;&nbsp;&nbsp;<b><a href="https://creativecommons.org/licenses/by-sa/4.0/legalcode.en">
https://creativecommons.org/licenses/by-sa/4.0/legalcode.en</a></b></p>
<p>You should <b>carefully review</b> all of the terms and conditions of the
<a href="https://creativecommons.org/licenses/by-sa/4.0/legalcode.en">actual license</a>
before using the licensed material.</p>
<p>You may wish to review the <b><a href="../../license.html">highlights of some of the key
features and terms</a></b> of the <a href="https://creativecommons.org/licenses/by-sa/4.0/legalcode.en">actual license</a>.</p>
<h2>Coda</h2>
<p><a href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F2018%2Fferguson%2FFILES.html">Nu HTML check this web page</a></p>
<p><a href="#top">Jump to top</a> <a href="#content">Jump to Content</a> <a href="#inventory">Jump to Inventory</a></p>
</div>
<!-- END: this line ends content from: inc/footer.default.html -->
<!-- START: this line starts content from: inc/bottom.default.html -->
</body>
</html>
<!-- END: this line ends content from: inc/bottom.default.html -->
+61
View File
@@ -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.
+1 -1
View File
@@ -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*