convert INABIAF headers in README.md to a Jargon File quote

We introduce a bit of fun, while specifying that something
is "supposed to happen".

NOTE: There is no need to change the INABIAF STATUS.  The use
there is perfectly fine.
This commit is contained in:
Landon Curt Noll committed 2023-11-02 17:17:40 -07:00
1 parent bd574c791c
commit f89a020d0f
21 files changed
+149 -47

No files matched your search

+8 -3
View File
@@ -47,10 +47,15 @@ echo -100 x 100 + 1 | ./robison
echo 100 / 100 | ./robison # <-- what happens here ? echo 100 / 100 | ./robison # <-- what happens here ?
``` ```
### INABIAF - it's not a bug it's a feature! :-) NOTE: This program will very likely crash or break into tiny bits
:-) if you feed it numbers with non-binary digits.
This program will very likely crash or break into tiny bits :-) if you feed it This is supposed to happen. As is written in the
numbers with non-binary digits. [The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
## Judges' remarks: ## Judges' remarks:
+6 -1
View File
@@ -43,7 +43,12 @@ vi tbr.c
What happens if you try using `cd -` to return to previous directory? What about What happens if you try using `cd -` to return to previous directory? What about
`cd` with no args? `cd` with no args?
### TNABTAF - they're not a bug they're a feature! :-) This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
The authors include a section called [BUGS](#bugs) that, because they were The authors include a section called [BUGS](#bugs) that, because they were
documented, are not considered bugs as such in the context of the contest. documented, are not considered bugs as such in the context of the contest.
+7 -2
View File
@@ -48,13 +48,18 @@ y1 - initial value (y(x1) == y1)
./theorem y 0 1 0.1 1 ./theorem y 0 1 0.1 1
``` ```
### INABIAF - it's not a bug it's a feature! :-)
If the two args passed to `fibonacci` and `theorem_bkp` equals 0 it will If the two args passed to `fibonacci` and `theorem_bkp` equals 0 it will
print 0 over and over again in an infinite loop. In this case it should not be print 0 over and over again in an infinite loop. In this case it should not be
fixed (another condition where this occurred was fixed as it affected usability fixed (another condition where this occurred was fixed as it affected usability
of the program). of the program).
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
BTW: why can't the fix: BTW: why can't the fix:
```c ```c
+7 -3
View File
@@ -39,13 +39,17 @@ What happens if you give the program a C program like itself? Try:
You'll get errors yes but what does the generated file look like? What about You'll get errors yes but what does the generated file look like? What about
other types of files? other types of files?
### INABIAF - it's not a bug it's a feature! :-)
Please note that if the BASIC file cannot be opened for reading or the output Please note that if the BASIC file cannot be opened for reading or the output
file cannot be opened for writing then this program will very likely crash or do file cannot be opened for writing then this program will very likely crash or do
something funny. something funny.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
These are a mild nuisance but are considered a feature not a bug. We challenge These are a mild nuisance but are considered a feature not a bug. We challenge
you to fix it for learning if you wish. See also [bugs.md](/bugs.md). you to fix it for learning if you wish. See also [bugs.md](/bugs.md).
+6 -1
View File
@@ -138,7 +138,12 @@ at the [International Obfuscated C Code Contest judges'
room](https://www.ioccc.org/https://www.ioccc.org/judges.html) they believe that room](https://www.ioccc.org/https://www.ioccc.org/judges.html) they believe that
you can win tic-tac-toe, that there can be acceptable draws. you can win tic-tac-toe, that there can be acceptable draws.
### INABIAF - it's not a bug it's a feature! :-) This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
Try not to cheat (even though it's very easy :-) ), the computer has not learned Try not to cheat (even though it's very easy :-) ), the computer has not learned
how to catch you doing it. how to catch you doing it.
+7 -2
View File
@@ -44,12 +44,17 @@ For more detailed information see [1992 kivinen in bugs.md](/bugs.md#1992-kivine
See also the author's remarks for other variations. See also the author's remarks for other variations.
### INABIAF - it's not a bug it's a feature! :-)
In modern systems a known issue is that when you start the game everything In modern systems a known issue is that when you start the game everything
starts to move to the right of the game window but if you click on the window it starts to move to the right of the game window but if you click on the window it
moves back to where it should be. moves back to where it should be.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
## Judges' remarks: ## Judges' remarks:
+7 -2
View File
@@ -25,10 +25,15 @@ where
`file` is a file containing some text. `file` is a file containing some text.
### INABIAF - it's not a bug it's a feature! :-)
This entry will segfault if the file cannot be opened. This is not a bug. This entry will segfault if the file cannot be opened. This is not a bug.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+7 -2
View File
@@ -32,11 +32,16 @@ For more detailed information see [2000 rince in bugs.md](/bugs.md#2000-rince).
./rince number number2 ./rince number number2
``` ```
### INABIAF - it's not a bug it's a feature! :-)
If `DISPLAY` is not set the program will very likely crash or do something If `DISPLAY` is not set the program will very likely crash or do something
different. different.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+8 -3
View File
@@ -58,9 +58,6 @@ What happens if you try it on another file like [anonymous.c](anonymous.c)? Can
you recompile it okay? What if you run it on `anonymous` itself? Can you run the you recompile it okay? What if you run it on `anonymous` itself? Can you run the
program successfully after it without recompiling? program successfully after it without recompiling?
### INABIAF - it's not a bug it's a feature! :-)
If you do not specify a 32-bit ELF binary as the arg of this program it will If you do not specify a 32-bit ELF binary as the arg of this program it will
very likely crash or do something terribly wrong like slaughtering all the very likely crash or do something terribly wrong like slaughtering all the
[elves](https://www.glyphweb.com/arda/e/elves.html) of [elves](https://www.glyphweb.com/arda/e/elves.html) of
@@ -70,6 +67,14 @@ that :-(
If the program cannot be run (for instance under macOS as an ELF file) then If the program cannot be run (for instance under macOS as an ELF file) then
the program will fail to execute it and might not even touch it. the program will fail to execute it and might not even touch it.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### A 2023 note about the warning from the author: ### A 2023 note about the warning from the author:
The author suggested that this *might* somewhat destroy the binaries this The author suggested that this *might* somewhat destroy the binaries this
+7 -2
View File
@@ -44,10 +44,15 @@ make alt
Use `dgbeards.alt` as you would `dgbeards` above. Can you find a flaw in this Use `dgbeards.alt` as you would `dgbeards` above. Can you find a flaw in this
version that the author did not note? version that the author did not note?
## INABIAF - it's not a bug it's a feature! :-)
This game crashes if it loses. This game crashes if it loses.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+7 -2
View File
@@ -29,10 +29,15 @@ For more detailed information see [2001 ollinger in bugs.md](/bugs.md#2001-ollin
./ollinger integer ./ollinger integer
``` ```
### INABIAF - it's not a bug it's a feature! :-)
This program will very likely crash or do something else without an arg. This program will very likely crash or do something else without an arg.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+7 -2
View File
@@ -29,8 +29,6 @@ For more detailed information see [2001 schweikh in bugs.md](/bugs.md#2001-schwe
./schweikh string string2 ./schweikh string string2
``` ```
### INABIAF - it's not a bug it's a feature! :-)
This program will very likely crash or do something else if you do not give it This program will very likely crash or do something else if you do not give it
two args. two args.
@@ -39,6 +37,13 @@ comments for details and a workaround.
There's also no way to escape meta characters. There's also no way to escape meta characters.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+7 -2
View File
@@ -52,11 +52,16 @@ diff remarks.md README.md # notice how similar they are
./sds < remarks.md ./sds < remarks.md
``` ```
### INABIAF - it's not a bug it's a feature! :-)
The generated code will very likely crash or do something else if not given a The generated code will very likely crash or do something else if not given a
proper command line. This is not a bug but a feature. proper command line. This is not a bug but a feature.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
## Judges' remarks: ## Judges' remarks:
+7 -2
View File
@@ -49,13 +49,18 @@ make alt
Use `anon.alt` as you would `anon`. Use `anon.alt` as you would `anon`.
### INABIAF - it's not a bug it's a feature! :-)
After a very large number of moves this program will deliberately force itself After a very large number of moves this program will deliberately force itself
to destroy its runtime stack. This is the author's way to prevent you from being to destroy its runtime stack. This is the author's way to prevent you from being
frustrated (which might happen as it likes to create unsolvable puzzles just to frustrated (which might happen as it likes to create unsolvable puzzles just to
hook you) and spending too much time playing. :-) hook you) and spending too much time playing. :-)
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
If you want to see this in action you can easily do this with the alt version: If you want to see this in action you can easily do this with the alt version:
```sh ```sh
+7 -2
View File
@@ -38,10 +38,15 @@ For more detailed information see [2006 monge in bugs.md](/bugs.md#2006-monge).
./monge "z = 0" "z = z*z*z + c; Abs2(z) < 4" ./monge "z = 0" "z = z*z*z + c; Abs2(z) < 4"
``` ```
### INABIAF - it's not a bug it's a feature! :-)
Incorrect formulas will ungracefully crash the program. Incorrect formulas will ungracefully crash the program.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
## Judges' remarks: ## Judges' remarks:
+7 -2
View File
@@ -32,12 +32,17 @@ For more detailed information see [2011 vik in bugs.md](/bugs.md#2011-vik).
An alternate version for Windows is available. See the Alternate code section An alternate version for Windows is available. See the Alternate code section
below. below.
### INABIAF - it's not a bug it's a feature! :-)
The author stated that the program will crash if no argument is passed tot he The author stated that the program will crash if no argument is passed tot he
program though we note that your computer might also [halt and catch program though we note that your computer might also [halt and catch
fire](https://en.wikipedia.org/wiki/Halt_and_Catch_Fire_(computing)) :-) fire](https://en.wikipedia.org/wiki/Halt_and_Catch_Fire_(computing)) :-)
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+7 -2
View File
@@ -60,13 +60,18 @@ To extract the embedded PNG:
There is an alternate version which might work for Windows. See Alternate code There is an alternate version which might work for Windows. See Alternate code
section below. section below.
### INABIAF - it's not a bug it's a feature! :-)
The author stated that the program will crash if no argument is passed to the The author stated that the program will crash if no argument is passed to the
program or if invalid arguments or images of mismatching sizes or unsupported program or if invalid arguments or images of mismatching sizes or unsupported
pixel formats though we note that your computer might also [halt and catch pixel formats though we note that your computer might also [halt and catch
fire](https://en.wikipedia.org/wiki/Halt_and_Catch_Fire_(computing)) :-) fire](https://en.wikipedia.org/wiki/Halt_and_Catch_Fire_(computing)) :-)
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
### Try: ### Try:
+8 -4
View File
@@ -70,11 +70,15 @@ diff 1.txt 2.txt
rm 1.txt 2.txt rm 1.txt 2.txt
``` ```
## INABIAF - it's not a bug it's a feature! :-)
This program will possibly crash or draw something funny with 0 args. Then This program will possibly crash or draw something funny with 0 args. Then
again it might not. :-) This is not a bug and should NOT be fixed. again it might not. :-)
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
Ask yourself the following questions: when will it crash, when will it draw Ask yourself the following questions: when will it crash, when will it draw
something funny (or will it ? :-) ) and when will it do nothing? something funny (or will it ? :-) ) and when will it do nothing?
+8 -3
View File
@@ -55,10 +55,15 @@ of the invocations above:
![./hou otherroom.scene - Other room](otherroom.jpg) ![./hou otherroom.scene - Other room](otherroom.jpg)
### INABIAF - it's not a bug it's a feature! :-)
This program does not terminate by itself: you must kill `hou` (but not Qiming This program does not terminate by itself: you must kill `hou` (but not Qiming
Hou :-) ) in order to end the program. This should not be fixed. Hou :-) ) in order to end the program.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
## Judges' remarks: ## Judges' remarks:
+7 -3
View File
@@ -43,13 +43,17 @@ Open another window / terminal.
Open more terminals and repeat... Open more terminals and repeat...
### INABIAF - it's not a bug it's a feature! :-)
WARNING: if the file is deleted it might lock any session still in use. These WARNING: if the file is deleted it might lock any session still in use. These
will have to be killed from another shell session or by closing the terminal will have to be killed from another shell session or by closing the terminal
tab. tab.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
NOTE: this entry might leave sockets lying about in the current working NOTE: this entry might leave sockets lying about in the current working
directory which you'll have to delete manually. Here's an example in macOS: directory which you'll have to delete manually. Here's an example in macOS:
+7 -2
View File
@@ -47,11 +47,16 @@ TZ=UTC48 make clobber prog
./prog 512 ./prog ./prog 512 ./prog
``` ```
### INABIAF - it's not a bug it's a feature! :-)
This program will not validate input so it might fail or get stuck if invoked This program will not validate input so it might fail or get stuck if invoked
erroneously. erroneously.
This is supposed to happen. As is written in the
[The Jargon File](http://catb.org/jargon/html/F/feature.html):
```
That's not a bug, that's a feature.
```
## Judges' remarks: ## Judges' remarks: