mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Improve FAQ about providing deobfuscated code

Browse Source 
It is preferable that unobfuscated code is by the author if they have
(and many have done exactly that).

It would also be preferable to include the author or authors of the entry or
entries if at all possible.

This update includes a link to how to find more information about an
author and I think that FAQ was slightly improved as well.
This commit is contained in:
Cody Boone Ferguson committed 2024-07-17 09:52:09 -07:00
1 parent b3311322af
commit 442cbfc664
2 files changed
+128 -71
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

faq.html
+61 -32
View File
@@ -469,7 +469,7 @@ other inconsistencies with the original entry?</a></li>
<li><a class="normal" href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a></li> <li><a class="normal" href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a></li>
<li><a class="normal" href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a></li> <li><a class="normal" href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a></li>
<li><a class="normal" href="#faq5_7">5.7 - How may I support the IOCCC?</a></li> <li><a class="normal" href="#faq5_7">5.7 - How may I support the IOCCC?</a></li>
<li><a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, how may I contribute the source?</a></li> <li><a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, may I contribute the source?</a></li>
</ul> </ul>
<h2 id="section-6---miscellaneous-ioccc">Section 6 - <a href="#faq6">Miscellaneous IOCCC</a></h2> <h2 id="section-6---miscellaneous-ioccc">Section 6 - <a href="#faq6">Miscellaneous IOCCC</a></h2>
<ul> <ul>
@@ -3324,50 +3324,72 @@ efforts, we suggest making an <strong>Anonymous</strong> gift via the
<a href="https://www.amazon.com/hz/wishlist/ls/3HSNTEL8RQ1M0?ref_=wl_share">IOCCC Amazon wishlist</a>.</p> <a href="https://www.amazon.com/hz/wishlist/ls/3HSNTEL8RQ1M0?ref_=wl_share">IOCCC Amazon wishlist</a>.</p>
<div id="faq5_8"> <div id="faq5_8">
<div id="deobfuscated"> <div id="deobfuscated">
<h3 id="faq-5.8-i-deobfuscated-some-entry-code-how-may-i-contribute-the-source">FAQ 5.8: I deobfuscated some entry code, how may I contribute the source?</h3> <h3 id="faq-5.8-i-deobfuscated-some-entry-code-may-i-contribute-the-source">FAQ 5.8: I deobfuscated some entry code, may I contribute the source?</h3>
</div> </div>
</div> </div>
<p>The <a href="judges.html">IOCCC judges</a> welcome those who wish to contribute <p><strong>PLEASE NOTE</strong>: <strong>many <a href="authors.html">winning authors</a></strong> have unobfuscated code
a <strong>deobfuscated</strong> version of a winning IOCCC entry: from either of their <strong>own entries</strong> and you should look for this first, often on GitHub or on
the <a href="authors.html">author(s)</a> or from people such as their website; see the FAQ on <a href="#author-information">how to find more information about a winning
yourself who are willing to contribute <strong>deobfuscated</strong> code. author of an entry</a> for how you might find this
We also welcome contributions to improve existing <strong>deobfuscated</strong> code.</p> information. We ask you to, if you can find them, please ask them what they
<p><strong>HISTORICAL NOTE</strong>: The IOCCC web site has shifted to a more think as they can often provide invaluable information; this is less of an issue
for fixes of bugs - not features - found in the <a href="bugs.html">bugs.html</a> file.</p>
<p>The <a href="judges.html">IOCCC judges</a> welcome those who wish to contribute a
<strong>deobfuscated</strong> version of a winning IOCCC entry: from either the <a href="authors.html">author or
authors</a> (<strong>which is much, much preferred</strong>) or from people such
as yourself (assuming you are not the author :-) ) who are willing to contribute
<strong>deobfuscated</strong> code. We also welcome contributions to improve existing
<strong>deobfuscated</strong> code. You might wish to look at their URL or alt URL (see below
for more details) <strong>first</strong> as quite a few <a href="authors.html">authors</a> have provided
unobfuscated code of their entries and this is far more fair to the <a href="authors.html">winning
authors</a> (and it is much more likely to be identical functionality
as well, though many <a href="authors.html">authors</a> are experienced and skilled enough
to add features <strong>after or during obfuscation!</strong> and many in fact do).</p>
<p><strong>HISTORICAL NOTE</strong>: The IOCCC website has shifted to a more
educational theme: preferring to explain entries rather than hiding educational theme: preferring to explain entries rather than hiding
things under the guise of such information being a “<em>spoiler</em>”. We things under the guise of such information being a “<em>spoiler</em>”. We
now use the term <strong>deobfuscated</strong> instead of “<em>spoiler</em>” for this reason.</p> now use the term <strong>deobfuscated</strong> instead of “<em>spoiler</em>” for this reason, at
<p>We ask that the <strong>deobfuscated</strong> code be identical to the least in most cases; other terms might be used, including on a rare occasion
functionality of the winning IOCCC entry code.</p> <em>spoiler</em>, this depending on context.</p>
<p><strong>NOTE</strong>: Be aware that IOCCC entry code may contain <strong>extremely <p>We ask that the <strong>deobfuscated</strong> code be <strong>identical in functionality</strong>
subtle and obscure side effects</strong> (i.e., features). Those wishing to the winning IOCCC entry code.</p>
to contribute a <strong>deobfuscated</strong> version of code should <strong>strive <p><strong>NOTE</strong>: Be aware that IOCCC entry code may contain <strong>extremely subtle and
to mimic</strong> the original (or existing <code>prog.c</code>code) IOCCC entry obscure side effects</strong> (i.e., features). Those wishing to contribute a
code as much as possible.</p> <strong>deobfuscated</strong> version of code should <strong>strive to mimic</strong> the original (or
existing) IOCCC entry code as much as possible. Some authors can be contacted
(see above for more details on this) and you could ask them for details and if
possible it would be good to include them in the discussion as well (see below)
as it is <strong>very likely</strong> there are things that will be missed when trying to
deobfuscate the code, some of which might be important to the author.</p>
<p>To contribute your <strong>deobfuscated</strong> code, please open up a <p>To contribute your <strong>deobfuscated</strong> code, please open up a
<a href="https://github.com/ioccc-src/temp-test-ioccc/discussions/new?category=show-and-tell">Show and tell new discussion</a>. <a href="https://github.com/ioccc-src/temp-test-ioccc/discussions/new?category=show-and-tell">Show and tell new discussion</a>
with a title of the form:</p> with a title of the form:</p>
<pre><code> Enhancement: deobfuscated code for YYYY/dirname</code></pre> <blockquote>
<p>where “<em>YYYY/dirname</em>” refers to the winning IOCCC entry for which you are de-obfuscating.</p> <p>Enhancement: deobfuscated code for YYYY/dirname</p>
</blockquote>
<p>where “<code>YYYY/dirname</code>” refers to the winning IOCCC entry for which you are deobfuscating.</p>
<p>In the <strong>body</strong> of your new discussion, <strong>PLEASE</strong> provide us with a <strong>URL</strong> of <p>In the <strong>body</strong> of your new discussion, <strong>PLEASE</strong> provide us with a <strong>URL</strong> of
your <strong>deobfuscated</strong> code, along with whatever notes and/or comments you your <strong>deobfuscated</strong> code, along with whatever notes and/or comments you
think might be helpful.</p> think might be helpful. If the author has a GitHub handle <strong>please</strong> mention
them in the discussion (see above part for how you might find out if they have a
GitHub account)!</p>
<p>If you are providing an improved version of some existing <strong>deobfuscated</strong> code, please <p>If you are providing an improved version of some existing <strong>deobfuscated</strong> code, please
mention that in the <strong>body</strong> of your new discussion as well.</p> mention that in the <strong>body</strong> of your new discussion as well.</p>
<p>If there are <strong>limitations</strong> to how well the your <strong>deobfuscated</strong> code minics <p>If there are <strong>limitations</strong> to how well the your <strong>deobfuscated</strong> code mimics
the original (or existing <code>prog.c</code>code) IOCCC entry code, <strong>PLEASE</strong> mention those <strong>limitations</strong> the original (or existing) IOCCC entry code, <strong>PLEASE</strong> mention those <strong>limitations</strong>
in the <strong>body</strong> of your new discussion as well.</p> in the <strong>body</strong> of your new discussion as well.</p>
<p>Any questions that may arise arise will be added as comments to the discussion.</p> <p>Any questions that may arise will be added as comments to the discussion.</p>
<p><strong>SUGGESTION</strong>: <strong>PLEASE</strong> try to make your <strong>deobfuscated</strong> code readable. <strong>PLEASE</strong> <p><strong>SUGGESTION</strong>: <strong>PLEASE</strong> try to make your <strong>deobfuscated</strong> code readable. <strong>PLEASE</strong>
add comments as needed to help the reader of your <strong>deobfuscated</strong> code understand it.</p> add comments as needed to help the reader of your <strong>deobfuscated</strong> code understand it.</p>
<p><strong>SUGGESTION</strong>: Where useful, consider providing, as <strong>C comments</strong>, <p><strong>SUGGESTION</strong>: Where useful, consider providing, as <strong>C comments</strong>,
code fragments of from the original (or existing <code>prog.c</code>code) IOCCC code fragments of from the original (or existing) IOCCC
entry code. While it is <strong>NOT</strong> necessary to include the entire entry code. While it is <strong>NOT</strong> necessary to include the entire
original code as <strong>C comments</strong>, including key parts from the original code as <strong>C comments</strong>, including key parts from the
original (or existing <code>prog.c</code>code) IOCCC entry code may be helpful original (or existing) IOCCC entry code may be helpful
to others who wish to read your <strong>deobfuscated</strong> code.</p> to others who wish to read your <strong>deobfuscated</strong> code.</p>
<p>If your <strong>deobfuscated</strong> is accepted (in some form), the <a href="judges.html">IOCCC judges</a> <p>If your <strong>deobfuscated</strong> is accepted (in some form), the <a href="judges.html">IOCCC judges</a>
will be happy to <strong>thank you</strong> for your contribution in the will be happy to <strong>thank you</strong> for your contribution in the
<a href="thanks-for-help.html">Thanking people for their help</a> file.</p> <a href="thanks-for-help.html">thanking people for their help file</a>.</p>
<p>The <a href="judges.html">IOCCC judges</a> will do the rest of the work in integrate your <p>The <a href="judges.html">IOCCC judges</a> will do the rest of the work in integrate your
<strong>deobfuscated</strong> code as an “<em>alt</em>” code for the entry <strong>AND</strong> will reference <strong>deobfuscated</strong> code as an “<em>alt</em>” code for the entry <strong>AND</strong> will reference
your <strong>deobfuscated</strong> code in the entry’s <code>index.html</code> file. We will be your <strong>deobfuscated</strong> code in the entry’s <code>index.html</code> file. We will be
@@ -4249,15 +4271,22 @@ the category <em>Website issue</em>).</p>
information on, you should see a section called <code>Author</code>. All you have to do is information on, you should see a section called <code>Author</code>. All you have to do is
click on the author’s name (it’s a link) and it will take you to their click on the author’s name (it’s a link) and it will take you to their
information in the <a href="authors.html">authors.html</a> page.</p> information in the <a href="authors.html">authors.html</a> page.</p>
<p>There you will find various information, sometimes just location (if that’s <p>There you will find various information including a link to their
known) and other times their mastodon handle (as a link), a link to their <a href="authors.html">authors.html</a> information which includes various things like
website (and sometimes an alt website), their GitHub handle (as a link) and a their GitHub account (if known), a URL or alternate UL, mastodon handle,
link to their <code>author.json</code> file (the link title is their name). That location (if known and not anonymous location) and a link to their JSON author
<code>author.json</code> file might have additional information. In all cases there is a file which has more information like email (if known).</p>
link to each of their winning entries.</p> <p><strong>NOTE</strong>: you might wish to search google (or some other search engine) by their
name as sometimes you can find out their GitHub account even if it’s not in our
JSON files.</p>
<p>Of course if you know the author’s name you can go directly to <p>Of course if you know the author’s name you can go directly to
<a href="authors.html">authors.html</a> and click on their surname’s/last name’s/second <a href="authors.html">authors.html</a> and click on their surname’s/last name’s/second
name’s initial and then scroll down (if necessary) to the author in question.</p> name’s initial and then scroll down (if necessary) to the author in question.</p>
<p><strong>NOTE</strong>: previously we included email in the <a href="authors.html">authors.html</a> page
but we have decided against this. Nevertheless, the <code>author_handle</code> link under
the author links to a JSON file which has the email address if it is known,
which you might wish to consult. You might also wish to look at their URL or
alternate URL for more information.</p>
<hr style="width:10%;text-align:left;margin-left:0"> <hr style="width:10%;text-align:left;margin-left:0">
<p>Jump to: <a href="#">top</a></p> <p>Jump to: <a href="#">top</a></p>
<!-- <!--
faq.md
+67 -39
View File
@@ -81,7 +81,7 @@ other inconsistencies with the original entry?](#faq4_3)
- <a class="normal" href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a> - <a class="normal" href="#faq5_5">5.5 - How may I correct or update IOCCC author information?</a>
- <a class="normal" href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a> - <a class="normal" href="#faq5_6">5.6 - What should I do if I find a broken or wrong web link?</a>
- <a class="normal" href="#faq5_7">5.7 - How may I support the IOCCC?</a> - <a class="normal" href="#faq5_7">5.7 - How may I support the IOCCC?</a>
- <a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, how may I contribute the source?</a> - <a class="normal" href="#faq5_8">5.8 - I deobfuscated some entry code, may I contribute the source?</a>
## Section 6 - [Miscellaneous IOCCC](#faq6) ## Section 6 - [Miscellaneous IOCCC](#faq6)
@@ -3896,74 +3896,93 @@ efforts, we suggest making an **Anonymous** gift via the
<div id="faq5_8"> <div id="faq5_8">
<div id="deobfuscated"> <div id="deobfuscated">
### FAQ 5.8: I deobfuscated some entry code, how may I contribute the source? ### FAQ 5.8: I deobfuscated some entry code, may I contribute the source?
</div> </div>
</div> </div>
The [IOCCC judges](judges.html) welcome those who wish to contribute **PLEASE NOTE**: **many [winning authors](authors.html)** have unobfuscated code
a **deobfuscated** version of a winning IOCCC entry: from either of their **own entries** and you should look for this first, often on GitHub or on
the [author&#x28;s&#x29;](authors.html) or from people such as their website; see the FAQ on [how to find more information about a winning
yourself who are willing to contribute **deobfuscated** code. author of an entry](#author-information) for how you might find this
We also welcome contributions to improve existing **deobfuscated** code. information. We ask you to, if you can find them, please ask them what they
think as they can often provide invaluable information; this is less of an issue
for fixes of bugs - not features - found in the [bugs.html](bugs.html) file.
**HISTORICAL NOTE**: The IOCCC web site has shifted to a more The [IOCCC judges](judges.html) welcome those who wish to contribute a
**deobfuscated** version of a winning IOCCC entry: from either the [author or
authors](authors.html) (**which is much, much preferred**) or from people such
as yourself (assuming you are not the author :-) ) who are willing to contribute
**deobfuscated** code. We also welcome contributions to improve existing
**deobfuscated** code. You might wish to look at their URL or alt URL (see below
for more details) **first** as quite a few [authors](authors.html) have provided
unobfuscated code of their entries and this is far more fair to the [winning
authors](authors.html) (and it is much more likely to be identical functionality
as well, though many [authors](authors.html) are experienced and skilled enough
to add features **after or during obfuscation!** and many in fact do).
**HISTORICAL NOTE**: The IOCCC website has shifted to a more
educational theme: preferring to explain entries rather than hiding educational theme: preferring to explain entries rather than hiding
things under the guise of such information being a "_spoiler_". We things under the guise of such information being a "_spoiler_". We
now use the term **deobfuscated** instead of "_spoiler_" for this reason. now use the term **deobfuscated** instead of "_spoiler_" for this reason, at
least in most cases; other terms might be used, including on a rare occasion
_spoiler_, this depending on context.
We ask that the **deobfuscated** code be identical to the We ask that the **deobfuscated** code be **identical in functionality**
functionality of the winning IOCCC entry code. to the winning IOCCC entry code.
**NOTE**: Be aware that IOCCC entry code may contain **extremely **NOTE**: Be aware that IOCCC entry code may contain **extremely subtle and
subtle and obscure side effects** (i.e., features). Those wishing obscure side effects** (i.e., features). Those wishing to contribute a
to contribute a **deobfuscated** version of code should **strive **deobfuscated** version of code should **strive to mimic** the original (or
to mimic** the original (or existing `prog.c`code) IOCCC entry existing) IOCCC entry code as much as possible. Some authors can be contacted
code as much as possible. (see above for more details on this) and you could ask them for details and if
possible it would be good to include them in the discussion as well (see below)
as it is **very likely** there are things that will be missed when trying to
deobfuscate the code, some of which might be important to the author.
To contribute your **deobfuscated** code, please open up a To contribute your **deobfuscated** code, please open up a
[Show and tell new discussion](https://github.com/ioccc-src/temp-test-ioccc/discussions/new?category=show-and-tell). [Show and tell new discussion](https://github.com/ioccc-src/temp-test-ioccc/discussions/new?category=show-and-tell)
with a title of the form: with a title of the form:
``` > Enhancement: deobfuscated code for YYYY/dirname
Enhancement: deobfuscated code for YYYY/dirname
```
where "_YYYY/dirname_" refers to the winning IOCCC entry for which you are de-obfuscating. where "`YYYY/dirname`" refers to the winning IOCCC entry for which you are deobfuscating.
In the **body** of your new discussion, **PLEASE** provide us with a **URL** of In the **body** of your new discussion, **PLEASE** provide us with a **URL** of
your **deobfuscated** code, along with whatever notes and/or comments you your **deobfuscated** code, along with whatever notes and/or comments you
think might be helpful. think might be helpful. If the author has a GitHub handle **please** mention
them in the discussion (see above part for how you might find out if they have a
GitHub account)!
If you are providing an improved version of some existing **deobfuscated** code, please If you are providing an improved version of some existing **deobfuscated** code, please
mention that in the **body** of your new discussion as well. mention that in the **body** of your new discussion as well.
If there are **limitations** to how well the your **deobfuscated** code minics If there are **limitations** to how well the your **deobfuscated** code mimics
the original (or existing `prog.c`code) IOCCC entry code, **PLEASE** mention those **limitations** the original (or existing) IOCCC entry code, **PLEASE** mention those **limitations**
in the **body** of your new discussion as well. in the **body** of your new discussion as well.
Any questions that may arise arise will be added as comments to the discussion. Any questions that may arise will be added as comments to the discussion.
**SUGGESTION**: **PLEASE** try to make your **deobfuscated** code readable. **PLEASE** **SUGGESTION**: **PLEASE** try to make your **deobfuscated** code readable. **PLEASE**
add comments as needed to help the reader of your **deobfuscated** code understand it. add comments as needed to help the reader of your **deobfuscated** code understand it.
**SUGGESTION**: Where useful, consider providing, as **C comments**, **SUGGESTION**: Where useful, consider providing, as **C comments**,
code fragments of from the original (or existing `prog.c`code) IOCCC code fragments of from the original (or existing) IOCCC
entry code. While it is **NOT** necessary to include the entire entry code. While it is **NOT** necessary to include the entire
original code as **C comments**, including key parts from the original code as **C comments**, including key parts from the
original (or existing `prog.c`code) IOCCC entry code may be helpful original (or existing) IOCCC entry code may be helpful
to others who wish to read your **deobfuscated** code. to others who wish to read your **deobfuscated** code.
If your **deobfuscated** is accepted (in some form), the [IOCCC judges](judges.html) If your **deobfuscated** is accepted (in some form), the [IOCCC judges](judges.html)
will be happy to **thank you** for your contribution in the will be happy to **thank you** for your contribution in the
[Thanking people for their help](thanks-for-help.html) file. [thanking people for their help file](thanks-for-help.html).
The [IOCCC judges](judges.html) will do the rest of the work in integrate your The [IOCCC judges](judges.html) will do the rest of the work in integrate your
**deobfuscated** code as an "_alt_" code for the entry **AND** will reference **deobfuscated** code as an "_alt_" code for the entry **AND** will reference
your **deobfuscated** code in the entry's `index.html` file. We will be your **deobfuscated** code in the entry's `index.html` file. We will be
happy to include any whatever notes and/or comments from your new discussion happy to include any whatever notes and/or comments from your new discussion
that be prove helpful. that be prove helpful.
**THANK YOU** in advance for your willingness to assist! **THANK YOU** in advance for your willingness to assist!
<div id="faq6"> <div id="faq6">
@@ -5324,17 +5343,26 @@ information on, you should see a section called `Author`. All you have to do is
click on the author's name (it's a link) and it will take you to their click on the author's name (it's a link) and it will take you to their
information in the [authors.html](authors.html) page. information in the [authors.html](authors.html) page.
There you will find various information, sometimes just location (if that's There you will find various information including a link to their
known) and other times their mastodon handle (as a link), a link to their [authors.html](authors.html) information which includes various things like
website (and sometimes an alt website), their GitHub handle (as a link) and a their GitHub account (if known), a URL or alternate UL, mastodon handle,
link to their `author.json` file (the link title is their name). That location (if known and not anonymous location) and a link to their JSON author
`author.json` file might have additional information. In all cases there is a file which has more information like email (if known).
link to each of their winning entries.
**NOTE**: you might wish to search google (or some other search engine) by their
name as sometimes you can find out their GitHub account even if it's not in our
JSON files.
Of course if you know the author's name you can go directly to Of course if you know the author's name you can go directly to
[authors.html](authors.html) and click on their surname's/last name's/second [authors.html](authors.html) and click on their surname's/last name's/second
name's initial and then scroll down (if necessary) to the author in question. name's initial and then scroll down (if necessary) to the author in question.
**NOTE**: previously we included email in the [authors.html](authors.html) page
but we have decided against this. Nevertheless, the `author_handle` link under
the author links to a JSON file which has the email address if it is known,
which you might wish to consult. You might also wish to look at their URL or
alternate URL for more information.
<hr style="width:10%;text-align:left;margin-left:0"> <hr style="width:10%;text-align:left;margin-left:0">