Landon Curt Noll
a2d8249e86
We improve the `inc/footer.default.html` file to make
the _Copyright and CC BY-SA 4.0 License_ clear.
We add `license.md` and generate `license.html` (via `make
gen_top_html`) so that key features and terms of the _Copyright and
CC BY-SA 4.0 License_ are accessible.
Add CC BY-SA 4.0 license images into the `png/` directory.
FYI: We use the license to allow the open use of IOCCC entry code,
and at the same time, we help ensure that those working on the IOCCC
have proper Attribution including, of course, the IOCCC winners
themselves! The _Copyright and CC BY-SA 4.0 License_ help ensure
that everyone may enjoy the IOCCC.
Added '#copyright' to all generated HTML pages so that the
_Copyright and CC BY-SA 4.0 License_ may be reached.
Changed `bin/gen-top-html.sh` VERSION from "1.2.2 2024-03-26"
to "1.2.3 2024-04-12".
Fix `bin/gen-sitemap.sh` to remove requirement of `ioccc.tar.bz2`.
Changed `bin/gen-sitemap.sh` VERSION from "1.3.4 2024-03-27"
to "1.3.5 2024-04-13".
Perform `make www sitemap` to perform the above.
We also give a _hint_ as to the next project.
TODO: Complete that next project we are _hinting_ at.
TODO: Review the work being done by a web designer to see
how their work might be incorporated into the web site.
329 lines
16 KiB
HTML
329 lines
16 KiB
HTML
<!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">
|
||
<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="sorta.README.md for 1991/brnstnd">
|
||
<meta name="keywords" content="IOCCC, 1991/brnstnd, sorta.README.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: 1991/brnstnd/sorta.README.md -->
|
||
<!-- -->
|
||
|
||
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
||
<!-- !!! Do not modify this web page, instead modify the file: 1991/brnstnd/sorta.README.md !!! -->
|
||
<!-- !!! Do not modify this web page, instead modify the file: 1991/brnstnd/sorta.README.md !!! -->
|
||
<!-- !!! Do not modify this web page, instead modify the file: 1991/brnstnd/sorta.README.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/header.default.html -->
|
||
|
||
<div class="header">
|
||
<img src="../../png/ioccc.png" alt="IOCCC image by Matt Zucker" width=300 height=110>
|
||
<h1>The International Obfuscated C Code Contest</h1>
|
||
<h2>sorta.README.md for 1991/brnstnd</h2>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/header.default.html -->
|
||
<!-- START: this line starts content from: inc/topnav.up2index.html -->
|
||
|
||
<div class="topnav">
|
||
<a class="Left" href="index.html">↑ jump to index.html ↑</a>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/topnav.up2index.html -->
|
||
<!-- START: this line starts content from: inc/begin-row.default.html -->
|
||
|
||
<div class="row">
|
||
|
||
<!-- END: this line ends content from: inc/begin-row.default.html -->
|
||
<!-- START: this line starts content from: inc/begin-leftcolumn.default.html -->
|
||
|
||
<div class="leftcolumn">
|
||
|
||
<!-- END: this line ends content from: inc/begin-leftcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/sidenav.default.html -->
|
||
|
||
<div class="sidenav">
|
||
<a href="#content">Jump to contents</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="../../index.html">IOCCC Home</a>
|
||
<a href="../../years.html">Winning Entries</a>
|
||
<a href="../../authors.html">People who have won</a>
|
||
<a href="../../location.html">Location of authors</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="../../news.html">IOCCC News</a>
|
||
<a href="../../status.html">Contest status</a>
|
||
<a href="../../faq.html#submit">How to enter the IOCCC</a>
|
||
<a href="../../faq.html">FAQ</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="../../bugs.html">Bugs & (mis)features</a>
|
||
<a href="../../faq.html#fix_an_entry">Fixing IOCCC entries</a>
|
||
<a href="../../faq.html#fix_web_site">Fixing the web site</a>
|
||
<a href="../../faq.html#fix_author">Fixing author info</a>
|
||
<a href="../../thanks-for-help.html">Thanks for the help</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="../../judges.html">The IOCCC Judges</a>
|
||
<a href="../../contact.html">Contacting the IOCCC</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="#top">Jump to top</a>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/sidenav.default.html -->
|
||
<!-- START: this line starts content from: inc/end-leftcolumn.default.html -->
|
||
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/end-leftcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/begin-rightcolumn.default.html -->
|
||
|
||
<div class="rightcolumn">
|
||
|
||
<!-- END: this line ends content from: inc/begin-rightcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/before-content.default.html -->
|
||
|
||
<a name="content"></a>
|
||
|
||
<!-- 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 -->
|
||
|
||
<p>The <code>sorta</code> scripts described below can sorta be found in this directory.</p>
|
||
<h1 id="sorta.i22"><a href="sorta.i2+2">sorta.i2+2</a></h1>
|
||
<pre><code> 2 2+#` [ about as basic as you can get ]ld</code></pre>
|
||
<p>This script takes 2, adds 2 to it, and prints the result (with a
|
||
newline). I get 5 on the hand-held Sinclair under ZYNIX. Let me know if
|
||
your machine produces a different result so that I can send you patches.</p>
|
||
<h1 id="sorta.iarg0"><a href="sorta.iarg0">sorta.iarg0</a></h1>
|
||
<pre><code> 0A` [ take arg 0, print it ]</code></pre>
|
||
<p>This is self-explanatory.</p>
|
||
<h1 id="sorta.icalc"><a href="sorta.icalc">sorta.icalc</a></h1>
|
||
<pre><code> [D2sD3s]:Dld [ input m n, output m n m n ]ld
|
||
|
||
[2*1=d]:cld [ aux routine for :d recursion ]ld
|
||
[1=D1s>1Ds_+=c]:dld [ input m n, as long as n <= m double it, output m n ]ld
|
||
|
||
[D2s1s_+1s]:-ld [ input m n, output m-n n ]ld
|
||
[1=D1s>1Ds_+#T=-2/D=1]:1ld [ aux routine for :@ ]ld
|
||
[1D=d2/1=1ddd1 ]:!ld
|
||
["0"Td]:0ld
|
||
[DD=!1_+=0]:@ld [ input m, m assumed nonnegative, append
|
||
binary representation of m to top of s stack ]ld
|
||
|
||
["-"T_]:+ld
|
||
[D0 1s>=+1=@]:2ld [ input m, append - to top of s stack if m is negative,
|
||
then append binary representation of abs(m) to
|
||
top of s stack ]ld
|
||
|
||
[d1A:A2=A]:A 27182 a1>=A
|
||
[d2A:A1=A]:A 3145 a2>=A
|
||
|
||
D # " in binary is "T 1=2 `ld
|
||
1=Dd # " in binary is "T 1=2 `ld
|
||
|
||
1=D 1s# " + "T 1s#T " is "T + #Td `ld
|
||
1=D 1s# " - "T 1s#T " is "T _+ #Td `ld
|
||
1=D 1s# " * "T 1s#T " is "T * #Td `ld
|
||
1=D 1s# " / "T 1s#T " is "T / #Td `ld
|
||
1=D 1s# " % "T 1s#T " is "T 1=D/*_+ #Td `ld
|
||
|
||
1=D d "~ " #T " is "T D& #T$ld " (" 1=2 ")"T `ld
|
||
1=D 1s# " & "T 1s#T " is "T &D& #T$ld " (" 1=2 ")"T `ld
|
||
1=D 1s# " | "T 1s#T " is "T D&1sD&& #T$ld " (" 1=2 ")"T `ld
|
||
1=D 1s# " ^ "T 1s#T " is "T 1=D&2sD&1sD&&&D& #T$ld " (" 1=2 ")"T `ld</code></pre>
|
||
<p><code>icalc</code> shows off <code>SORTA</code>’s understanding of integer arithmetic. You can run
|
||
it with up to two arguments; the arguments have default values of 27182
|
||
and 3145. Notice that <code>SORTA</code> doesn’t have a language primitive for
|
||
converting a string to a number, yet <code>icalc</code> is performing arithmetic on
|
||
its arguments. Can you see how? (Hint: Try <code>./sorta "2 2+" 3 < sorta.icalc</code>.
|
||
Look at program A.) <code>icalc</code> also provides a useful binary output routine,
|
||
and if you can’t remember offhand that <code>D2sD3s&2sD&1sD&&&D&</code> means XOR,
|
||
you can just look it up here.</p>
|
||
<h1 id="sorta.idup"><a href="sorta.idup">sorta.idup</a></h1>
|
||
<pre><code> [ld#1_+1=y]:x
|
||
[uD1+=x]:y
|
||
0""1=y`</code></pre>
|
||
<p>This script prints out the maximum file descriptor available from
|
||
repeated <code>dup(2)</code>s—usually <code>NOFILE - 1</code>. Can you see how it works?</p>
|
||
<h1 id="sorta.iecho"><a href="sorta.iecho">sorta.iecho</a></h1>
|
||
<pre><code> [" "$ld]:sld [ print a space ]ld
|
||
[1s1+DA$ld1s1_+D=sD=x]:xld [ given n (argc-n), print args ]ld
|
||
0a1_+D=x""` [ simulation of /bin/echo ]ld</code></pre>
|
||
<p>This is a clone of <code>/bin/echo</code>, minus any argument processing and escape
|
||
interpretation. (Note that, unlike some shells’ echo, <code>/bin/echo</code> prints a
|
||
newline even with no arguments.) Try <code>./sorta foo bar < iecho</code>.</p>
|
||
<h1 id="sorta.ifact1"><a href="sorta.ifact1">sorta.ifact1</a></h1>
|
||
<pre><code> 1#`ld2*#`ld3*#`ld4*#`ld5*#`ld6*#`ld7*#`ld8*#`ld9*#`ld10*#`ld</code></pre>
|
||
<p>This is a very straightforward factorial program: Take 1, print it,
|
||
multiply by 2, print it, multiply by 3, print it, etc.</p>
|
||
<h1 id="sorta.ifact2"><a href="sorta.ifact2">sorta.ifact2</a></h1>
|
||
<pre><code> [1+D2s*#`ld1s]:f
|
||
1 0
|
||
1=f 1=f 1=f 1=f 1=f 1=f 1=f 1=f 1=f 1=f</code></pre>
|
||
<p><code>ifact1</code> does a lot of repeated work. <code>ifact2</code> takes advantage of this by
|
||
keeping the current <code>n!</code> <code>n</code> on the stack. Each call to routine <code>f (1=f)</code>
|
||
increments <code>n</code> by <code>1</code> and prints out the factorial.</p>
|
||
<h1 id="sorta.ifact3"><a href="sorta.ifact3">sorta.ifact3</a></h1>
|
||
<pre><code> [1+D2s*#`ld1s]:f [ given (n-1)! (n-1), print n!, put n! n ]
|
||
[2s1=f2s1_+D0>=x]:x [ given n n! x, print (n+1)! through (n+x)! ]
|
||
0 1 10 1=x</code></pre>
|
||
<p>Finally, <code>ifact3</code> removes all the redundancy from <code>ifact2</code>, and exhibits
|
||
proper documentation of stack routines. You can replace the <code>10</code> by
|
||
anything in this version.</p>
|
||
<h1 id="sorta.iio"><a href="sorta.iio">sorta.iio</a></h1>
|
||
<pre><code> [ a simple example of interpreting code on the fly ]ld
|
||
|
||
["] "2 2+":xT ["]T " produces "T 1=x#T " which should be 4."T`</code></pre>
|
||
<p>Notice that <code>"2 2+"</code> is a literal string inside the program.</p>
|
||
<h1 id="sorta.irot13"><a href="sorta.irot13">sorta.irot13</a></h1>
|
||
<pre><code> "[] [.tr] "
|
||
["]".[a-m][n-z][A-M][N-Z]"[" ]TTT ["]".[n-z][a-m][N-Z][A-M]"[" ]TTT
|
||
"[tr] !q"T:xld
|
||
["rot13: fatal: need exactly one argument"`q]:gld
|
||
["rot13: fatal: cannot open "1ST`q]:hld
|
||
a2_+=g
|
||
1A 0 [ that 0 is for RDONLY ]ld
|
||
0 'o D0 1s>=hld
|
||
0Ou1=x [ in a more complex spawner, this would be done under a fork ]ld</code></pre>
|
||
<p>Despite its name, <code>irot13</code> is meant to show how to exec a program with
|
||
redirection from within <code>sorta</code>. You run it as <code>./sorta blah < irot13</code>; it
|
||
opens <code>blah</code> and runs a (BSD-style) <code>tr</code> command to rotate all letters by 13
|
||
spots. <code>1A 0 0 o</code> opens <code>argv[1]</code>; the <code>'</code> keeps the filename around for
|
||
subroutine <code>h</code> to print a nice error message if necessary. <code>0Ou</code> closes
|
||
stdout and replaces it with the new descriptor. Finally, subroutine <code>x</code>
|
||
executes the <code>tr</code>.</p>
|
||
<h1 id="sorta.isleep"><a href="sorta.isleep">sorta.isleep</a></h1>
|
||
<pre><code> ["" "+sleep" "+5" "sleep" !q]:S [F0>1_+=S]:s
|
||
"forking sleep 5..."`ld
|
||
1=s
|
||
"waiting for sleep to finish..."`ld
|
||
w
|
||
"done, sleep exit code " #T`</code></pre>
|
||
<p>This script illustrates the classic fork-exec-wait.</p>
|
||
<h1 id="sorta.itailrec"><a href="sorta.itailrec">sorta.itailrec</a></h1>
|
||
<pre><code> [3*#" "T$ldD=f]:f
|
||
1=f</code></pre>
|
||
<p>The sole purpose of this script is to prove that <code>sorta</code> can do infinite
|
||
tail recursion (in this case, in program <code>f</code>). Do <code>./sorta < itailrec | more</code>
|
||
and watch the powers of 3 (mod your computer’s word size) flow by.</p>
|
||
<h1 id="sorta.iwhosort"><a href="sorta.iwhosort">sorta.iwhosort</a></h1>
|
||
<pre><code> [0Ou "" "+-u" "sort" !q]:S [F0>1_+=S]:s
|
||
[1Ou "" "+-u" "who" !q]:W [F0>1_+=W]:w
|
||
P1=wO1=sOww</code></pre>
|
||
<p>This final example is a simple pipeline, <code>who | sort</code>.</p>
|
||
<!--
|
||
|
||
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/
|
||
|
||
-->
|
||
|
||
<!-- 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 -->
|
||
|
||
<!-- END: this line ends content from: inc/after-content.default.html -->
|
||
<!-- START: this line starts content from: inc/end-rightcolumn.default.html -->
|
||
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/end-rightcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/end-row.default.html -->
|
||
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/end-row.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">
|
||
<h2><a name="copyright"></a>Copyright and CC BY-SA 4.0 License</h2>
|
||
<p>All IOCCC content including this file and web page are:</p>
|
||
<b> Copyright © 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 xmlns:cc="http://creativecommons.org/ns#" ><b><a href="https://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1"
|
||
target="_blank" rel="license noopener noreferrer" style="display:inline-block;"> CC BY-SA 4.0
|
||
<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;"
|
||
src="../..//svg/cc.svg"
|
||
alt="cc inside circle symbol">
|
||
<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;"
|
||
src="../..//svg/by.svg"
|
||
alt="person inside circle symbol">
|
||
<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;"
|
||
src="../..//svg/sa.svg"
|
||
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> <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=#">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 -->
|