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

reverted most quotes in guidelines.md

Browse Source 
The way that markdown quotes are currently formatted (with a gray
vertical line) looks too much like a change bar.  The change bar
is an important tool to help notice new and changed rules and
guidelines.  Unfortunately the current quotes style looks too much
like a change bar, so we use markdown quotes **ONLY** for literal
quotes (such as from Mark Twain) in the `guidelines.md` file.
This commit is contained in:
Landon Curt Noll committed 2024-06-24 15:01:02 -07:00
1 parent 51130083c4
commit 5c710b39e7
2 files changed
+58 -60
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

next/guidelines.html
+26 -41
View File
@@ -514,13 +514,11 @@ code against the 2nd limit of <a href="rules.html#rule2">Rule 2</a>, use the -i
For example:</p> For example:</p>
<pre><code> ./iocccsize -i &lt; prog.c</code></pre> <pre><code> ./iocccsize -i &lt; prog.c</code></pre>
<p>The IOCCC size tool, when using the -i option, may be summarized as:</p> <p>The IOCCC size tool, when using the -i option, may be summarized as:</p>
<blockquote> <pre><code> The size tool counts most C reserved words (keyword, secondary,
<p>The size tool counts most C reserved words (keyword, secondary,<br> and selected preprocessor keywords) as 1. The size tool counts all
and selected preprocessor keywords) as 1. The size tool counts all<br> other octets as 1 excluding ASCII whitespace, and excluding any
other octets as 1 excluding ASCII whitespace, and excluding any<br> &#39;`;`&#39;, &#39;`{`&#39; or &#39;`}`&#39; followed by ASCII whitespace, and excluding any
‘<code>;</code>’, ‘<code>{</code>’ or ‘<code>}</code>’ followed by ASCII whitespace, and excluding any<br> &#39;`;`&#39;, &#39;`{`&#39; or &#39;`}`&#39; octet immediately before the end of file.</code></pre>
‘<code>;</code>’, ‘<code>{</code>’ or ‘<code>}</code>’ octet immediately before the end of file.</p>
</blockquote>
<p>ASCII whitespace includes ASCII tab, ASCII space, ASCII newline, <p>ASCII whitespace includes ASCII tab, ASCII space, ASCII newline,
ASCII formfeed, and ASCII carriage return.</p> ASCII formfeed, and ASCII carriage return.</p>
<p><strong><code>|</code></strong> When ‘<code>;</code>’, ‘<code>{</code>’ or ‘<code>}</code>’ are within a C string, they may still not be <p><strong><code>|</code></strong> When ‘<code>;</code>’, ‘<code>{</code>’ or ‘<code>}</code>’ are within a C string, they may still not be
@@ -890,49 +888,36 @@ following compiler flag:</p>
<p>If there are limitations in your entry, you are highly encouraged <p>If there are limitations in your entry, you are highly encouraged
to note such limitations in your remarks file. For example if your to note such limitations in your remarks file. For example if your
entry factors values up to a certain size, you might want to state:</p> entry factors values up to a certain size, you might want to state:</p>
<blockquote> <pre><code>This entry factors values up 2305567963945518424753102147331756070.
<p>This entry factors values up 2305567963945518424753102147331756070. Attempting to factor larger values will produce unpredictable results.</code></pre>
Attempting to factor larger values will produce unpredictable results.</p>
</blockquote>
<p>The judges might try to factor the value -5, so you want to might state:</p> <p>The judges might try to factor the value -5, so you want to might state:</p>
<blockquote> <pre><code>This entry factors positive values up 2305567963945518424753102147331756070.
<p>This entry factors positive values up 2305567963945518424753102147331756070. Attempting to factor large values will produce unpredictable results.</code></pre>
Attempting to factor large values will produce unpredictable results.</p>
</blockquote>
<p>However the judges might try to also factor 0, so you want to might state:</p> <p>However the judges might try to also factor 0, so you want to might state:</p>
<blockquote> <pre><code>This entry factors values between 1 and 2305567963945518424753102147331756070.
<p>This entry factors values between 1 and 2305567963945518424753102147331756070.
Attempting to factor values outside that range will produce unpredictable Attempting to factor values outside that range will produce unpredictable
results.</p> results.</code></pre>
</blockquote>
<p>Moreover the try to also factor 3.5 or 0x7, or Fred, so you want to might state:</p> <p>Moreover the try to also factor 3.5 or 0x7, or Fred, so you want to might state:</p>
<blockquote> <pre><code>This entry factors integers between 1 and 2305567963945518424753102147331756070.
<p>This entry factors integers between 1 and Attempting to factor anything else will produce unpredictable results.</code></pre>
2305567963945518424753102147331756070. Attempting to factor anything else will
produce unpredictable results.</p>
</blockquote>
<p>You entry might be better off catching the attempt to factor bogus values <p>You entry might be better off catching the attempt to factor bogus values
and doing something interesting. So you might want to code accordingly and state:</p> and doing something interesting. So you might want to code accordingly and state:</p>
<blockquote> <pre><code>This entry factors integers between 1 and 2305567963945518424753102147331756070.
<p>This entry factors integers between 1 and Attempting to factor anything else will cause the program to insult your pet fish Eric.</code></pre>
2305567963945518424753102147331756070. Attempting to factor anything else will
cause the program to insult your pet fish Eric.</p>
</blockquote>
<p>The judges might not have a pet fish named Eric, so might want to state:</p> <p>The judges might not have a pet fish named Eric, so might want to state:</p>
<blockquote> <p>``
<p>This entry factors integers between 1 and This entry factors integers between 1 and 2305567963945518424753102147331756070.
2305567963945518424753102147331756070. Attempting to factor anything else will Attempting to factor anything else will cause the program to insult your pet fish Eric,
cause the program to insult your pet fish Eric, or in the case that you lack or in the case that you lack such a pet, will insult the pet that you do not have.</p>
such a pet, will insult the pet that you do not have.</p> <pre><code>
</blockquote> When all other things are equal, an entry with fewer limitation will be judged
<p>When all other things are equal, an entry with fewer limitation will be judged better than an entry with lots of limitations. So you might want to code accordingly
better than an entry with lots of limitations. So you might want to code accordingly and state:
and state:</p> </code></pre>
<blockquote>
<p>This entry attempts to a factor value of any size provided that the program is <p>This entry attempts to a factor value of any size provided that the program is
given enough time and memory. If the value is not a proper integer, the program given enough time and memory. If the value is not a proper integer, the program
will insult a fish named Eric, even if such a fish does not exist.</p> will insult a fish named Eric, even if such a fish does not exist.
</blockquote> ```</p>
<p><strong><code>|</code></strong> We <strong>DISLIKE</strong> the use of use ASCII tab characters in markdown files, such as in the required <code>remarks.md</code> file.</p> <p><strong><code>|</code></strong> We <strong>DISLIKE</strong> the use of use ASCII tab characters in markdown files, such as in the required <code>remarks.md</code> file.</p>
<p><strong><code>|</code></strong> We don’t mind the use ASCII tab characters in your C code. Feel free to use ASCII tab characters if that suits your obfuscation needs. If is perfectly <strong>OK</strong> to use tab characters elsewhere in your submission, just not in markdown files as this tends complicate and annoys us when be comes to rendering your markdown content.</p> <p><strong><code>|</code></strong> We don’t mind the use ASCII tab characters in your C code. Feel free to use ASCII tab characters if that suits your obfuscation needs. If is perfectly <strong>OK</strong> to use tab characters elsewhere in your submission, just not in markdown files as this tends complicate and annoys us when be comes to rendering your markdown content.</p>
<p><strong><code>|</code></strong> If you do use ASCII tab characters in your non-markdown files, be aware that some people may use tab stop that is different than the common 8 character tab stop.</p> <p><strong><code>|</code></strong> If you do use ASCII tab characters in your non-markdown files, be aware that some people may use tab stop that is different than the common 8 character tab stop.</p>
next/guidelines.md
+32 -19
View File
@@ -187,11 +187,13 @@ For example:
The IOCCC size tool, when using the -i option, may be summarized as: The IOCCC size tool, when using the -i option, may be summarized as:
> The size tool counts most C reserved words (keyword, secondary,<br> ```
> and selected preprocessor keywords) as 1. The size tool counts all<br> The size tool counts most C reserved words (keyword, secondary,
> other octets as 1 excluding ASCII whitespace, and excluding any<br> and selected preprocessor keywords) as 1. The size tool counts all
> '`;`', '`{`' or '`}`' followed by ASCII whitespace, and excluding any<br> other octets as 1 excluding ASCII whitespace, and excluding any
> '`;`', '`{`' or '`}`' octet immediately before the end of file. '`;`', '`{`' or '`}`' followed by ASCII whitespace, and excluding any
'`;`', '`{`' or '`}`' octet immediately before the end of file.
```
ASCII whitespace includes ASCII tab, ASCII space, ASCII newline, ASCII whitespace includes ASCII tab, ASCII space, ASCII newline,
ASCII formfeed, and ASCII carriage return. ASCII formfeed, and ASCII carriage return.
@@ -710,47 +712,58 @@ If there are limitations in your entry, you are highly encouraged
to note such limitations in your remarks file. For example if your to note such limitations in your remarks file. For example if your
entry factors values up to a certain size, you might want to state: entry factors values up to a certain size, you might want to state:
> This entry factors values up 2305567963945518424753102147331756070. ```
This entry factors values up 2305567963945518424753102147331756070.
Attempting to factor larger values will produce unpredictable results. Attempting to factor larger values will produce unpredictable results.
```
The judges might try to factor the value -5, so you want to might state: The judges might try to factor the value -5, so you want to might state:
> This entry factors positive values up 2305567963945518424753102147331756070. ```
This entry factors positive values up 2305567963945518424753102147331756070.
Attempting to factor large values will produce unpredictable results. Attempting to factor large values will produce unpredictable results.
```
However the judges might try to also factor 0, so you want to might state: However the judges might try to also factor 0, so you want to might state:
> This entry factors values between 1 and 2305567963945518424753102147331756070. ```
This entry factors values between 1 and 2305567963945518424753102147331756070.
Attempting to factor values outside that range will produce unpredictable Attempting to factor values outside that range will produce unpredictable
results. results.
```
Moreover the try to also factor 3.5 or 0x7, or Fred, so you want to might state: Moreover the try to also factor 3.5 or 0x7, or Fred, so you want to might state:
> This entry factors integers between 1 and ```
2305567963945518424753102147331756070\. Attempting to factor anything else will This entry factors integers between 1 and 2305567963945518424753102147331756070.
produce unpredictable results. Attempting to factor anything else will produce unpredictable results.
```
You entry might be better off catching the attempt to factor bogus values You entry might be better off catching the attempt to factor bogus values
and doing something interesting. So you might want to code accordingly and state: and doing something interesting. So you might want to code accordingly and state:
> This entry factors integers between 1 and ```
2305567963945518424753102147331756070\. Attempting to factor anything else will This entry factors integers between 1 and 2305567963945518424753102147331756070.
cause the program to insult your pet fish Eric. Attempting to factor anything else will cause the program to insult your pet fish Eric.
```
The judges might not have a pet fish named Eric, so might want to state: The judges might not have a pet fish named Eric, so might want to state:
> This entry factors integers between 1 and ``
2305567963945518424753102147331756070\. Attempting to factor anything else will This entry factors integers between 1 and 2305567963945518424753102147331756070.
cause the program to insult your pet fish Eric, or in the case that you lack Attempting to factor anything else will cause the program to insult your pet fish Eric,
such a pet, will insult the pet that you do not have. or in the case that you lack such a pet, will insult the pet that you do not have.
```
When all other things are equal, an entry with fewer limitation will be judged When all other things are equal, an entry with fewer limitation will be judged
better than an entry with lots of limitations. So you might want to code accordingly better than an entry with lots of limitations. So you might want to code accordingly
and state: and state:
> This entry attempts to a factor value of any size provided that the program is ```
This entry attempts to a factor value of any size provided that the program is
given enough time and memory. If the value is not a proper integer, the program given enough time and memory. If the value is not a proper integer, the program
will insult a fish named Eric, even if such a fish does not exist. will insult a fish named Eric, even if such a fish does not exist.
```
**`|`** We **DISLIKE** the use of use ASCII tab characters in markdown files, such as in the required `remarks.md` file. **`|`** We **DISLIKE** the use of use ASCII tab characters in markdown files, such as in the required `remarks.md` file.